Crowd IT Unified MCP 服务器
使用说明内容(Markdown格式)
-
项目简介 Crowd IT Unified MCP 服务器是一个基于 Model Context Protocol 的后端服务,旨在以标准化的方式向大语言模型(LLM)客户端提供上下文信息和功能。核心能力包括对各类资源的托管与访问、工具的注册与执行,以及 Prompt 模板的定义和渲染。服务器通过 JSON-RPC 与客户端通信,支持会话管理、能力声明,并具备在云环境下的无状态部署能力。
-
主要功能点
- 资源与数据访问:集中管理一组“资源/数据源”,支持从各类外部系统读取、查询、更新等操作。
- 工具注册与调用:注册大量工具/接口,LLM 可以通过统一入口调用外部功能。
- Prompt 模板与交互:定义和渲染用于对话的 Prompt 模板,提供可定制的 LLM 交互模式。
- JSON-RPC 协议通信:服务器接收 JSON-RPC 请求并返回 JSON-RPC 响应,确保与各种 LLM 客户端的兼容性。
- 多传输协议支持:实现类 API 的传输层抽象,确保在 STDIO、SSE、WebSocket 等场景下工作。
- 会话与能力描述:服务器端负责会话管理、能力声明,便于 LLM 客户端了解可用能力。
- 环境与服务过滤(可选):通过 ENABLED_SERVICES 环境变量按需加载服务,降低令牌消耗并可拆分成多服务器部署。
-
安装步骤
- 获取代码
- 将仓库克隆到本地或服务器:git clone <仓库地址>,进入项目目录。
- 安装依赖
- 本地开发:按照 README 提示,执行 pip install -r pyproject.toml(该项目使用 pyproject.toml 作为依赖描述文件)。
- 启动服务器
- 本地开发:执行 python server.py 启动 MCP 服务器。
- 生产/云环境:当前实现支持 Cloud Run 等无状态部署,Cloud Run URL 在 README 中给出。
- 健康检查
- 服务器启动后,访问健康端点(README 提供的 Cloud Run 健康探针支持)确保服务就绪。
- 获取代码
-
服务器配置(供 MCP 客户端连接的配置信息,JSON 格式,客户端无需直接运行服务器) { "server_name": "Crowd IT MCP Server", "command": "python", "args": ["server.py"], "notes": "这是 MCP 服务器的运行信息,用于客户端在会话建立阶段了解服务器标识与启动命令。实际连接由客户端在初始化时使用。" }
-
基本使用方法
- 连接与会话
- 向 MCP 服务器发起 JSON-RPC 请求,携带客户端能力描述与请求信息,服务器返回相应结果或通知。
- 服务与工具使用
- 通过已注册的工具入口,LLM 可以调用外部服务、查询资源、执行操作。
- 资源与权限管理
- 服务器端负责资源的托管、访问控制与会话管理,确保多任务并发与并发隔离。
- 部署与扩展
- 支持按服务拆分成多台 MCP 服务器以降低单次请求的工具定义传输开销;也可在云环境中进行无状态扩展。
- 连接与会话