使用说明

项目简介
- 该仓库包含多个基于 MCP 的服务器实现，分别对接客户相关接口和财务相关接口，使用 FastMCP 以 HTTP 传输实现工具暴露，供 LLM 客户端调用。服务器实现了初始化会话、执行工具调用（如查询客户、获取订单历史等）以及通过 JSON-RPC 与客户端交互的核心能力。
主要功能点
- MCP 服务器：按 MCP 协议处理请求、返回工具调用结果、支持 HTTP 传输模式。
- 工具暴露：通过装饰器或注册的工具向 MCP 客户端暴露具体操作，例如查询客户、获取订单历史、查询发票、处理票据等。
- 与外部系统对接：通过 REST/数据库等后端服务获取数据并返回给 MCP 客户端。
- 安全与可扩展性：可通过添加更多工具、扩展服务端逻辑来支持更复杂的工作流。
安装步骤
1. 确保安装了 Python 3.8 及以上环境。
2. 安装依赖（具体依赖请参考各 MCP 服务器脚本的导入需求，通常包括 fastmcp、httpx、并行库等）。
3. 启动 Customer MCP 服务：
  - 进入 fantaco-mcp-servers/customer-mcp 目录
  - 运行 python customer-api-mcp-server.py
  - 服务器监听端口通常为 9001（通过环境变量 PORT_FOR_CUSTOMER_MCP 指定）
4. 启动 Finance MCP 服务：
  - 进入 fantaco-mcp-servers/finance-mcp 目录
  - 运行 python finance-api-mcp-server.py
  - 服务器监听端口通常为 9002（通过环境变量 PORT_FOR_FINANCE_MCP 指定）
服务器配置（MCP 客户端需要的配置信息，JSON 格式）为便于 MCP 客户端与服务器建立连接，请使用如下配置方式（JSON，仅作说明，不是代码）： { "servers": [ { "name": "Customer MCP Server", "command": "python customer-api-mcp-server.py", "args": [ "PORT_FOR_CUSTOMER_MCP=9001", "HOST_FOR_CUSTOMER_MCP=0.0.0.0" ] }, { "name": "Finance MCP Server", "command": "python finance-api-mcp-server.py", "args": [ "PORT_FOR_FINANCE_MCP=9002", "HOST_FOR_FINANCE_MCP=0.0.0.0" ] } ], "notes": "每个服务器暴露的工具通过 MCP 客户端以 tools/call 请求访问，初始的 initialize 请求用于建立会话。具体路由通常为 http(s)://<host>:<port>/mcp（HTTP 传输）。" }
基本使用方法
- 通过 MCP 客户端连接并初始化会话，随后列出可用工具，按名称调用对应工具，获得返回结果。
- 在对话型应用中，LLM 可以通过 MCP 工具触发数据查询、执行外部调用并将结果回传给对话系统实现更丰富的上下文交互。

关键词

信息