UNITARES MCP 服务器

使用说明（简要概览，便于快速落地）：

• 项目简介
  • UNITARES MCP 服务器是一套基于 MCP 的后端实现，面向 LLM 客户端提供资源与工具管理、提示模板渲染、以及可扩展的上下文服务，支持多种传输协议与会话管理。
• 主要功能点
  • 资源与数据访问：对资源进行托管、查询与更新，以支持上下文构建。
  • 工具注册与执行：注册可调用的外部工具，LLM 可以通过 JSON-RPC 调用执行这些工具。
  • Prompt 模板定义与渲染：定义可定制的 Prompt 模板，渲染后用于与 LLM 交互。
  • JSON-RPC 通信：通过标准的 JSON-RPC 进行请求/响应，支持回调通知等场景。
  • 会话与能力声明：对会话进行管理并声明服务器能力，便于客户端发现可用特性。
  • 多传输协议支持：提供 STDIO（单客户端）、HTTP 流（SSE）等多种传输方式，适配不同部署场景。
• 安装与运行
  • 运行环境：Python 3.12 及以上，按项目文档安装所需依赖。
  • 安装步骤（简化版）：
    1. 克隆仓库并进入目录
    2. 安装依赖
    3. 以多客户端模式启动 MCP 服务器（示例端口8767）
       • python src/mcp_server.py --port 8767
    4. 或使用 STDIO 模式（单客户端）
       • python src/mcp_server_std.py
  • 服务器配置（客户端使用的 JSON 配置示例，具体字段可与客户端对接方确认）： { "mcpServers": { "unitares": { "type": "http", "url": "http://localhost:8767/mcp/", "headers": { "X-Agent-Name": "MyAgent" } } } }
• 基本使用方法
  • 客户端准备：将 MCP 服务器配置加入客户端，指定服务器名称、启动命令与参数等（配置对客户端透明，服务器端实现无需改动）。
  • 资源与工具调用：通过 JSON-RPC 请求读取资源、调用工具、获取 Prompt 等。
  • 会话管理与安全：服务器端负责会话上下文与能力声明，必要时结合安全策略和鉴权进行访问控制。
  • 开发与扩展：若需要扩展资源、工具或 Prompt 模板，可以在服务端实现对应的资源/工具/模板管理逻辑，并通过 JSON-RPC 暴露新接口。
• 运行与部署要点
  • 参考仓库的 README、文档与测试用例，确保依赖、数据库/缓存等后端组件按需正确配置。
  • 如需与 Cursor、Claude Desktop 等客户端配合，请按 MCP_SETUP 指南进行 ngrok、端口映射等高级配置。
  • 持续集成测试请使用仓库提供的测试用例，如 governance_core、mcp_server_std、mcp_handlers 等模块的测试。