AgentMesh MCP Tool Server
使用说明
- 项目简介
- 该仓库中包含一个可运行的 MCP 服务器实现示例（在 examples/01-mcp-tool-server 目录下），用于展示如何在 AgentMesh 治理体系下搭建一个对 MCP 请求进行策略、审计、信任验证和合规渗透保护的后端服务器。服务器通过 JSON-RPC 方式处理 MCP 客户端的请求，并对工具调用进行审计、权限控制和信任评估。
- 主要功能点
- MCP 请求处理：接收 MCP 客户端的工具调用请求（如 filesystem_read、database_query、api_call 等），并返回 JSON-RPC 响应。
- 策略与治理：内置策略引擎对工具调用进行评估，决定是否允许执行；可扩展为严格/宽松策略模式。
- 审计与可追溯：对工具调用与结果进行审计记录，支持后续验证和合规报告。
- 信任与 delegation：与 AgentMesh 的信任体系协同，记录并使用信任分数对接入进行额度与访问控制。
- 基础的工具实现与演示：示例服务器提供对常见工具的模拟实现，并展示如何将治理策略贯穿到工具执行流程中。
- 安装步骤
- 该服务器是一个示例应用，直接运行以下命令即可启动演示环境（需已安装 Python 3.11+）。
- 运行命令（示例）：
- python examples/01-mcp-tool-server/main.py
- 运行后，服务器将暴露一个演示用的工具集合，按模板处理 MCP 客户端的请求并输出 JSON-RPC 响应与审计信息。
- 服务器配置
- 配置信息（示例 JSON，供 MCP 客户端理解如何连接服务器；注意：MCP 客户端本身不需要该配置，仅用于描述服务器侧信息）
- server name: agentmesh-mcp-tool-server
- command: python
- args: ["examples/01-mcp-tool-server/main.py"]
- 说明: 这是一个演示用 MCP 工具服务器，包含策略、审计与信任治理组件。
- 基本使用方法
- 启动后，MCP 客户端发送类似以下 JSON-RPC 请求格式的工具调用：
- 请求类型：工具调用（method: "tools/call"）
- 参数 name: 工具名（如 "filesystem_read"）
- 参数 arguments: 调用参数（如 { "path": "/data/users.json" }）
- 服务器将：
- 进行输入审核与策略评估
- 如通过，将执行模拟工具并返回结果
- 记录审计并返回相应的 JSON-RPC 响应
- 客户端可以从服务器返回的结果中查看工具执行结果、可能的策略拒绝原因以及审计信息
- 启动后，MCP 客户端发送类似以下 JSON-RPC 请求格式的工具调用：