Quantum Ledger 财务 MCP 服务器

关键词

金融自动化大语言模型工具执行报表生成JSON-RPC

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了一个完整的 MCP 服务器，用于向 MCP 客户端提供“资源/工具/提示”等上下文介面，便于 LLM 客户端通过 JSON-RPC 访问并执行金融、会计相关功能，同时包含与 Gemini 大语言模型的桥接组件以增强推理与工具调用能力。

  • 主要功能点

    • MCP 服务器核心能力：通过 MCP 框架注册并暴露工具，接收 JSON-RPC 请求，执行工具，并返回标准化的 JSON-RPC 响应与通知。
    • 工具集成：提供一组用于财务场景的工具，如创建账务分录、工资计算、获取税务规则、工作区路由查找、报表生成等。
    • Gemini 桥接层：内置 lib/mcp/geminiBridge.ts，实现通过 Gemini 调用外部模型，动态选择并执行 MCP 工具。
    • 人工审核与审批流：提供 approvalStore.ts 等钩子，支持对敏感操作的人工确认流程。
    • standalone MCP stdio 服务脚本：scripts/mcp-financial-server.ts，便于直接在命令行启动服务器。
    • MCP 设置样例：docs/mcp-settings.sample.json，展示如何为 MCP 客户端配置服务器。
    • 多语言/跨模块能力：桥接层与跨模块路由，支持将请求路由到会计、税务、报表等不同子系统。

  • 安装步骤

    • 安装依赖并构建环境（请根据项目实际仓库的 package.json 安装依赖，例如 npm install 或 yarn、pnpm 等）。
    • 运行 MCP 服务器（示例命令）：npm run mcp:server
    • 如需直接使用脚本启动（便携场景），可执行脚本 mcp-financial-server.ts（需具备 TS 运行环境，如 ts-node/tsx 等）。
    • 使用 Gemini 前，请配置环境变量 GEMINI_API_KEY（及可选 GOOGLE_GEMINI_API_KEY 等），以便模型桥接能够正常工作。

  • 服务器配置（MCP 客户端所需配置） 服务器配置示例（JSON 结构，描述性文本）： { "serverName": "quantum-ledger-financial", "command": "npx", "args": ["tsx", "scripts/mcp-financial-server.ts"], "cwd": "<仓库根路径>", "env": { "GEMINI_API_KEY": "<你的 Gemini API Key, 必要时可配置其他 API Key 如 GOOGLE_GEMINI_API_KEY>" } // 说明： // - serverName：MCP 客户端将用于标识该 MCP 服务器的名称。 // - command/args：在本地启动服务器所需的命令与参数，示例对应 README 中的启动方式。 // - cwd：运行时工作目录，通常为仓库根目录。 // - env：环境变量，用于提供模型钥匙等必要信息。 }

  • 基本使用方法

    • 启动后，MCP 客户端即可通过标准的 JSON-RPC 调用访问以下能力：
      • 注册并调用工具（如创建账务分录、计算工资、获取税务规则、查找工作区路由、生成报表等）。
      • 通过工具集合实现资源、工具、提示模板的标准化访问与渲染。
      • 通过 Gemini 桥接模型实现对复杂请求的推理与工具执行组合。
    • 客户端使用 MCP 服务器的启动命令和参数后，即可向 MCP 服务器发起请求，得到 JSON-RPC 响应或通知，完成现场上下文服务的提供。

  • 重要注意

    • MCP 服务器实现包含一个核心的工具注册与执行流程、以及一个 Gemini 桥接层，确保在需要时可以调用外部模型来增强推理和工具执行。
    • 服务器脚本还包含 Standalone 模式、测试用例和示例设置，帮助开发、调试和本地部署。

服务器信息

访问项目