ERP-Analytics MCP 服务端

使用说明内容（Markdown格式）

• 项目简介

  • 该仓库实现了一个以 MCP（Model Context Protocol）为基础的服务器端组件，专注于提供企业资源计划（ERP）相关工具以及分析工具的注册、查询与执行能力。服务器通过 MCP 标准接口暴露工具、允许客户端调用工具，并可通过标准化的 JSON-RPC 与客户端交互。

• 主要功能点

  • MCP 服务器端实现：处理 ListTools（列出可用工具）与 CallTool（调用工具）的请求与响应，符合 MCP 的核心通信模式。
  • 工具集合：包含 ERP 相关工具（如创建产品、创建客户、创建订单、更新库存、查询库存、查询订单、查询员工等）以及分析工具（财务、库存、销售、员工与 KPI 报告等）。
  • 数据模拟与分析能力：基于内置的 mock 数据、随机数据与简单逻辑，提供用于演示与测试的综合数据输出。
  • 多工具执行链：支持在工具执行过程中进行多轮交互，通过 MCP 客户端逐步调用工具。
  • 纯服务器端实现：提供独立的 MCP 服务器逻辑，且通过 stdio 传输适合进程间协作场景（server 端启动后通过标准输入输出与客户端通信）。

• 安装步骤

  • 需要环境：Node.js（适用于常规 Node 环境）
  • 参考步骤（简化版）：
    1. 克隆仓库到本地
    2. 安装依赖（如 npm install）
    3. 启动 MCP 服务器：在命令行运行服务器文件所在路径的 Node 命令，例如启动脚本所在的位置执行 node src/mcp_server/index.js
    4. 使用 MCP 客户端连接该服务器（客户端需要提供启动命令及参数以启动服务器进程并与之通信，详见下方配置信息）

• 服务器配置（MCP 客户端需要的最小配置信息） 说明：MCP 客户端连接该服务器时，至少需要提供服务器启动方式的参数（start command 与参数），以便创建对应的传输通道并建立连接。以下为基于仓库实现的准确配置要点（以 JSON 形式描述，非代码块呈现）：

  • server name: erp-mcp
  • command: node
  • args: ["./src/mcp_server/index.js"]
  • 说明：该配置让 MCP 客户端通过命令行启动该服务器进程，并使用标准输入输出（stdio）作为传输通道（服务器在启动后通过标准输入输出与客户端通信）。
  • 其他可选字段（如 clientName、capabilities、auth、headers 等）可根据实际部署需求在客户端进行扩展配置；本服务器实现要求的最小字段如上所述即可建立连接。

• 基本使用方法（示例流程，易于操作）

  1. 启动服务器进程：按照上述配置在独立环境中启动服务器脚本（node src/mcp_server/index.js）。服务器将通过 stdio 接受连接并暴露工具。
  2. 连接并获取工具列表：通过 MCP 客户端建立连接后，向服务器请求 ListTools，获取 ERP 与分析工具的名称和输入模式。
  3. 调用工具：选择需要的工具，按输入模式提供参数，发送 CallTool 请求，服务器将执行相应逻辑并返回结果与执行上下文（包括可能的工具调用记录）。
  4. 查看结果：解析服务器返回的输出、摘要、以及执行细节，如需要可继续进行更多工具调用或查询其他分析数据。
  5. 断开连接与清理：完成测试后，客户端关闭连接，服务器可根据需要清理资源。

• 备注

  • 本实现包含一个 ERP 与分析工具集合的服务器端实现，以及辅助的数据模拟与工具处理逻辑，适用于测试、演示与红队/安全评估场景下对工具执行与能力边界的验证。实际生产环境请结合真实数据源与安全策略进行替换与加强。