使用说明

• 项目简介

  • 该仓库实现了基于 MCP 的可信服务器端（Trusted MCP），用于向大语言模型客户端提供结构化上下文、资源与工具等能力，并在传输层实现了安全性增强（如端到端加解密、信任能力扩展等）。
  • 同时提供面向 MCP 客户端的示例客户端实现，便于测试与集成。

• 主要功能点

  • MCP 服务端核心：能够处理 MCP 请求/响应，注册并暴露工具、资源以及提示相关能力，支持对话式上下文管理。
  • 信任与安全：对通信进行信任能力扩展，支持在普通环境与机密环境中运行，并通过加密网关与密钥管理实现端到端加解密。
  • 多传输协议支持：内置对流式与非流式传输的处理，兼容标准 MCP 客户端的请求/响应模式。
  • 案例与演示：仓库包含 demo/server.py、demo/aicc_server.py、demo/aicc_client.py、demo/local_client.py 等示例，展示如何启动服务器、进行简单工具调用、以及与客户端的交互流程。

• 安装步骤

  • 首选方式：通过 Python 包管理工具安装 Trusted MCP（参考 README 的快速开始）。
  • 或在开发环境中从源码使用，确保 Python3.10+ 及相关依赖就绪。

• 服务器配置说明

  • MCP 服务器配置用于 MCP 客户端在连接时了解服务器启动与运行参数。配置内容应以 JSON 形式提供，包含以下字段（示例说明，不给出实际代码块）：
    • server_name: 服务端名称（如 Weather service）。
    • command: 启动服务器的命令（如 uv 或 python），用于 MCP 客户端生成连接指令。
    • args: 启动命令的参数数组（如 ["run","python","demo/server.py","--host","0.0.0.0","--port","8000"]）。
    • 其他可选字段（如端口、主机、以及与安全相关的配置项）可按实际部署环境补充。
  • 注：MCP 客户端需要这些信息来生成与服务器建立连接的启动指令，但实际使用时请遵循仓库内演示脚本和注释中的步骤。

• 基本使用方法

  • 运行服务器（示例与演示所用方式）：按照演示脚本中给出的启动方式执行，例如在 Weather service 示例中通过 uvicorn/uv runner 启动 demo/server.py，监听指定主机和端口。
  • 配置 MCP 客户端：提供服务器的启动命令及参数（如上所述的 JSON 配置），MCP 客户端据此与服务器建立连接。
  • 调用工具与上下文：客户端连接后，可以通过 MCP 约定的工具接口进行调用；服务器会返回相应的 JSON-RPC 风格响应，以及必要的上下文信息。
  • 安全与证书：根据需要配置密钥对、证书及相关安全参数，确保跨组件间的认证与加密。