PEAC MCP 服务器实现（归档版）

使用说明（Markdown 格式）

• 项目简介

  • 该代码库中包含一个 MCP 服务器实现的归档版本，遵循 MCP 的基本思想：通过 JSON-RPC 与客户端进行通信，服务器承担会话管理、能力声明以及资源、工具等对象的注册与执行。归档版实现基于 Node.js/TypeScript 的服务器端逻辑，支持以标准 MCP 方式接收请求并返回 JSON-RPC 响应。

• 主要功能点

  • MCP 协议核心能力演示：实现标准的 JSON-RPC 请求/响应循环，包含对初始化、工具调用、以及相关操作的处理路径。
  • 工具注册与调用：服务器暴露工具接口（如收据发行、收据验证、批量验证等），客户端可通过工具调用来完成相应功能。
  • 证据与签名能力演示：通过集成的签名/验证能力（依赖 @peac/core 等实现）来处理带有签名的收据，支持离线验证和证据 bundle 的基础场景。
  • 安全与扩展性：具备能力 déclarations、会话管理以及简单的密钥与证书管理入口，便于对接多种客户端与扩展实现。

• 安装步骤

  • 环境准备：请在具备 Node.js 的环境下运行，推荐使用与项目相近的版本（归档实现常见为 Node.js/TypeScript 环境中的打包产物）。
  • 构建与运行（示例性说明）：
    • 将 MCP 服务器相关源码构建成可执行产物（通常通过打包工具将 server.ts 转换为 dist/server.js 之类的产物）。
    • 运行生成的服务器二进制或脚本文件来启动 MCP 服务器。
  • 注意：由于该实现位于归档目录，实际生产部署可能需按现有构建流程将归档代码编译成可运行形式后再部署。

• 服务器配置（JSON 配置，给 MCP 客户端用于连接的示例信息）

  • server_name: peac-mcp-server
  • command: node
  • args: ["dist/server.js"]（具体路径请以实际打包产物位置为准）
  • 注释说明：该配置仅用于 MCP 客户端通过启动命令与参数连接 MCP 服务器进行交互的示例。MCP 客户端需要的是真正的服务器启动命令及参数，以便建立标准的 JSON-RPC 通道。实际环境中，请根据你们的打包产物位置替换上述路径和命令。

• 基本使用方法

  • 启动后，客户端可通过 MCP 的标准路径发送 JSON-RPC 请求（如初始化能力、调用工具、请求资源等）。
  • 客户端应先通过初始化/能力广告阶段了解服务器的可用工具和资源类型，然后按需调用相应工具（例如发行收据、验证收据等），服务器返回标准的 JSON-RPC 响应。
  • 服务器端会维护会话与能力声明，并对请求进行基本的访问控制与错误处理，便于后续扩展和集成到更大生态。

• 重要注意事项

  • 该实现属于归档示例，若要在实际系统中使用，请确保对接的客户端与服务器端版本、打包产物路径、密钥管理等符合你们的运行环境与安全要求。