Plexo MCP 服务器

使用说明（简要帮助开发者快速上手）：

• 项目简介

  • Plexo MCP 服务器是一个符合 MCP 标准的后端服务，提供资源、工具和提示模板等上下文信息服务，并通过 JSON-RPC 与 LLM 客户端通信。支持两种传输：Streamable HTTP（基于 Node.js HTTP 模块的传输实现）与 Stdio（标准输入/输出传输，常用于本地开发与 Claude Code 等场景）。

• 主要功能点

  • MCP 服务器核心能力：接收客户端请求（如读取资源、调用工具、获取 Prompts），返回标准的 JSON-RPC 响应或通知。
  • 会话管理与上下文注入：对每个请求维持上下文（workspace、token、scopes），并将上下文传递给工具处理逻辑。
  • 安全性与限流：内置令牌校验、速率限制、权限检查，确保工具调用在授权范围内执行。
  • 工具与健康接口：提供 plexo_health、plexo_workspace_info 等系统工具，便于健康检查与工作区信息查询。
  • 可扩展性设计：支持通过插件/工具扩展 MCP 服务的能力，具备日志、审计、监控等钩子。
  • 多传输支持：HTTP 传输用于与 MCP 客户端（如 Cursor/ Claude Desktop）对接，Stdio 传输用于本地开发与集成。

• 安装步骤

  • 依赖与打包：克隆仓库后安装依赖并构建 MCP 服务包（dist）。
  • 运行方式
    • 通过 HTTP 传输启动（推荐环境变量配置后运行）：
      • MCP_TRANSPORT 设置为 http，MCP_PORT 设置监听端口，示例默认端口为 3002。
    • 通过 Stdio 传输启动（本地开发/测试场景）：
      • MCP_TRANSPORT 设置为 stdio，必须提供 PLEXO_MCP_TOKEN 以完成初始认证。
  • 运行示例（非代码描述，供配置理解）
    • 使用环境变量设置传输和端口，在无修改服务器代码的情况下，直接启动 dist/index.js 即可提供 MCP 服务。

• 服务器配置（用于 MCP 客户端接入的配置示例，非代码区分描述）

  • 服务器名称：plexo-mcp
  • 启动命令：node
  • 启动参数：dist/index.js
  • 传输模式：http
  • 端口：3002
  • 附加说明：若使用 stdio，请使用 MCP_TRANSPORT=stdio 并提供 PLEXO_MCP_TOKEN 做身份认证。MCP 客户端在建立连接前应将服务器名称、启动命令与参数（命令行参数）告知 MCP 服务端以完成连接初始化。

• 基本使用方法

  • 启动后，客户端通过 MCP 的 JSON-RPC 规范向服务端发送请求（如读取资源、调用工具、获取 Prompts）。
  • 服务端返回标准化的 JSON-RPC 响应，包含结果或错误码，便于 LLM 客户端进行后续处理。
  • 通过 Console/日志可观察健康与工作区信息接口的输出，以确保服务可用性与正确性。

• 注意事项

  • MCP 传输的安全性：严格校验令牌、作用域与权限，避免泄露凭证。
  • 日志与错误处理：服务端对敏感信息进行脱敏与日志化，避免泄露凭证。
  • 容错与可观测性：健康检查、工作区信息统计、审计日志等多维观测点，帮助调试与运维。