Crew MCP 服务器

使用说明（Markdown 格式）：

• 项目概览
  • Crew MCP 服务器是一个后端实现，按 MCP 标准暴露三类原语：Prompts（可调用的提示模板）、Resources（原始定义用于上下文读取）、Tools（可注册并执行的外部功能）。通过 JSON-RPC 与客户端通信，支持本地(stdin/stdout)、SSE、HTTP 等传输模式。
• 主要功能点
  • 资源托管与访问：统一管理员工定义、模板与记忆等上下文资源，LLM 客户端可读取/查询资源。
  • 工具注册与执行：定义并注册一组工具，LLM 可以通过工具调用实现外部功能。
  • Prompt 模板管理：加载、渲染并暴露员工 Prompt 模板，支持可定制的交互模式。
  • JSON-RPC API：通过标准的 JSON-RPC 请求/响应进行资源读取、工具调用、Prompts 获取等操作。
  • 会话与能力声明：内置会话管理、能力声明、状态查询等，便于多会话并发与追踪。
  • 多传输协议支持：内置 stdio（本地 IDE 连接）、SSE、HTTP transport，灵活部署。
  • 安全与可扩展性：Bearer Token、CORS、速率限制、日志、追踪、断路等生产就绪特性。
• 安装步骤
  • 安装 MPC 依赖：pip install knowlyr-crew[mcp]
  • 启动 stdio 模式（本地开发/IDE 集成）：
    • 运行 Crew MCP 服务的命令，UI 中设置 mcpServers，保持与客户端的连接
  • 启动 SSE/HTTP 传输（远程部署）：
    • mcp 模式下启动服务器并通过 -t sse/ -t http 指定传输类型
  • Bearer 认证（生产环境推荐）：
    • 使用 --api-token 或 KNOWLYR_CREW_API_TOKEN 环境变量进行 Bearer 认证
• MCP 服务器配置（示例配置，供 MCP 客户端读取并连接）
  • 配置文件示例（JSON）： { "mcpServers": { "crew": { "command": "knowlyr-crew", "args": ["mcp"] } } }
  • 说明：
    • server 名称：crew（MCP 客户端通过该名称识别并连接对应服务器）
    • command：执行 MCP 服务器进程的命令，示例为 knowlyr-crew
    • args：启动参数，这里传入 "mcp" 表示以 MCP 模式启动
• 基本使用方法
  • 客户端与服务器建立连接后，按 MCP 标准发送 JSON-RPC 请求，读取资源、执行工具、获取 Prompts 等
  • 服务器端会话管理、能力声明、健康检查等接口将对接客户端的状态与能力
  • 通过 '/health' / '/metrics' 等端点可观测服务健康与性能
• 运行要点
  • 服务器模式下应提供 Bearer token 认证、CORS、请求大小等生产准备特性
  • 需要将员工定义、资源与工具以 MCP 规范暴露，客户端可按需求组合调用
• 使用建议
  • 将 MCP 服务部署到服务器，结合 Claude Code/Cursor 等 AI IDE 使用，统一管理技能上下文
  • 按需启用 SSE/HTTP 传输，提升远程客户端的实时性与安全性