xProof MCP 服务器端
使用说明(Markdown 格式)
-
项目简介
- 该仓库实现了一个基于 MCP(Model Context Protocol)的后端服务器,核心职责是以标准化的 JSON-RPC 调用向 LLM 客户端提供上下文信息与能力,包括托管资源、注册与执行工具、以及定义/渲染提示模板等。服务器通过 MCP 端点(POST /mcp)与客户端通信,支持工具调用、资源读取、以及提示模板等功能。
-
主要功能点
- MCP 端点支持:POST /mcp,按 MCP 2.0 规范处理 initialize、tools/list、tools/call、resources/list、resources/read 等请求。
- 工具集成:实现 certify_file、verify_proof、get_proof、discover_services、audit_agent_session、check_attestations 等工具,允许 LLM 客户端或自动化代理调用。
- 资源与工具发现:提供 .well-known/mcp.json 作为 MCP 发现文档,以及相关工具和资源的元信息。
- 安全与认证:通过认证中间件对 API Key 进行鉴权,部分 MCP 工具要求 Bearer pm_xxx 风格的 API Key。
- 附加能力:集成对 x402、ACP、MX-8004、OpenAI Plugin、LangChain、CrewAI 等协议与生态的对接与文档化支持。
- 与后端其他系统协同:结合区块链证据记录、预测定价、以及对账/排队等机制,提供完整的后端能力。
-
安装步骤
- 下载或克隆代码后,在项目根目录执行安装依赖命令以取得所需的 Node.js 模块。
- 按照环境要求配置数据库连接、区块链钥匙、以及外部服务的凭证与端点地址(例如 MultiversX 网关、Base 链等)。
- 启动服务后,服务器会在指定端口监听,对外暴露 MCP、AC P、x402 等多协议能力。
-
服务器配置(MCP 客户端所需信息说明) 说明:MCP 客户端需要提供触发 MCP 服务的连接信息,以建立与 MCP 服务器的通讯。以下配置文本为 JSON 格式的描述文本,便于理解字段含义(实际客户实现中,请以文本形式提供,不作为代码块直接执行): { "server_name": "xproof-mcp", "command": "node", "args": [ "dist/server/index.js", "--port", "5000" ], "notes": "启动 MCP 服务端的主进程及监听端口。该配置用于 MCP 客户端建立连接并进行初始化/工具调用等交互。实际运行时应确保环境变量(数据库、区块链、鉴权等)已正确设置。" }
-
基本使用方法
- 启动后,MCP 客户端通过 JSON-RPC 2.0 请求向 /mcp 端点发送 MCP 请求(如 initialize、tools/list、tools/call、resources/list、resources/read)。
- 客户端可以调用 certify_file、verify_proof 等工具,通过 MCP 获取所需上下文信息与能力输出,再由 LLM 客户端进行后续处理。
- MCP Manifest 与资源/工具元数据在 /.well-known/mcp.json 和相关工具定义中暴露,便于自动发现与集成。