项目简介

这是一个轻量级的 Model Context Protocol (MCP) 服务端，旨在为大型语言模型 (LLM) 客户端提供基础的会计操作能力。它通过 MCP 协议暴露工具，允许 LLM 调用外部功能来管理交易记录。该服务端依赖于一个单独的 RESTful API 后端来实际存储和管理数据。

主要功能点

• 添加交易记录: LLM 可以调用此功能，根据提供的来源、金额和类型（贷方/借方）向记账系统添加新的交易条目。
• 查询所有交易: LLM 可以调用此功能来获取当前系统中存储的所有交易记录的列表，并将其作为上下文信息使用。

安装步骤

1. 准备环境: 确保你已安装 Node.js (推荐 v14+) 和 Docker（如果需要容器化部署）。
2. 启动后台API服务: 该MCP服务端依赖一个后台服务来处理数据存储。在项目根目录运行脚本启动此服务：

   ./run.sh
   

   这通常会启动数据库和后台 API 服务器。
3. 构建MCP服务端: 进入'mcp_server'目录，安装依赖并构建项目：

   cd mcp_server
   npm i
   npm run build
   

服务器配置

该MCP服务端是通过标准输入/输出 (Stdio) 协议与MCP客户端通信。你需要将以下信息添加到你的MCP客户端的配置文件中，以便客户端能够找到并启动这个服务器：

你需要配置一个MCP服务器条目，例如命名为 'accounting'。配置信息需要指定如何启动该服务器进程。这通常包括：

• 启动命令 ('command'): 指定运行MCP服务器的可执行程序。对于此项目，应设置为 'node'。
• 启动参数 ('args'): 指定传递给启动命令的参数列表。列表中的第一个参数应该是MCP服务器主入口文件的绝对路径。根据构建步骤，这个文件是 '/你的项目绝对路径/mcp_server/build/index.js'。请务必将'/你的项目绝对路径/'替换为你实际的项目文件夹所在的绝对路径。

基本使用方法

一旦你的MCP客户端配置并成功连接到此服务端，LLM将能够发现并使用该服务端提供的工具。LLM可以通过自然语言请求来执行记账操作，例如：

• “请记录一笔来自‘兼职’的1200元入账。” (这会触发 'add-transaction-entry' 工具)
• “请告诉我目前所有的交易记录。” (这会触发 'get-all-transaction-entries' 工具)

服务端将执行相应的后台操作（通过调用其内部依赖的RESTful API），并将结果（如操作成功提示或交易列表）返回给LLM客户端。