Conductor MCP Server (STDIO)

关键词

Model Context ProtocolJSON-RPCSTDIO资源暴露工具暴露
  • 使用场景概览
    • 该仓库包含一个 MCP 服务器实现，基于 stdio 传输暴露 MCP 服务端能力，供 MCP 客户端（如 Cursor、Claude Desktop 等）通过标准的 JSON-RPC 请求进行交互。
    • 服务器核心职责包括：托管与管理 Resources（数据访问）、注册与执行 Tools（外部功能调用）、定义与渲染 Prompts（上下文/模板），并通过 JSON-RPC 响应返回结果或通知。
  • 主要功能点
    • MCP 服务端实现：支持通过 stdio 传输接收 MCP 请求（如读取资源、执行工具、获取 Prompts）并返回 JSON-RPC 风格的响应。
    • 资源暴露：公开用于客户端访问的 Resources（如 conductor://projects、conductor://sessions）。
    • 工具暴露：提供诸如 conductor_dispatch、conductor_list_sessions、conductor_session_status、conductor_list_projects、conductor_kill_session 等工具接口，便于客户端调度任务、查询状态等。
    • 配置化 MCP 服务：通过 conductor 配置可为不同项目注册专用 MCP 服务器及参数，支持灵活的多服务器场景。
    • 本地化部署：通过 STDIO 传输，适合本地无网络依赖的场景，安全可控。
  • 安装与运行步骤
      1. 安装依赖并构建仓库
      • 在仓库根目录执行安装/构建步骤，确保依赖就绪（通常使用 pnpm/npm/yarn 根据仓库文档进行）。
      1. 启动 MCP 服务器
      • 使用命令行工具启动 MCP 服务器（CLI 的 mcp-server 子命令），例如：
        • co mcp-server
      1. 客户端接入配置
      • MCP 客户端需要配置一个 MCP 服务器项，包含服务器名称、启动命令及参数等。示例（JSON 文本，不作为代码块展示）： { "mcpServers": { "conductor": { "command": "conductor-oss", "args": ["mcp"] } // 如有多服务器可继续追加 } // 其余全局 MCP 配置按客户端需求添加 }
  • MCP 服务器配置（给 MCP 客户端的描述性信息）
    • server name: conductor
    • command: conductor-oss
    • args: ["mcp"]
    • 说明：该配置用于指示 MCP 客户端通过指定的可执行文件（conductor-oss）及参数（mcp）连接并使用该 MCP 服务器。
  • 基本使用方法
    • 启动后，客户端通过 MCP 协议向服务器发起请求，读取资源、调用工具、获取/渲染 Prompt。
    • 服务器会返回标准的 JSON-RPC 响应，或在需要时通过通知/事件推送方式告知客户端状态变更。
    • 服务器端实现会根据会话、项目等上下文进行能力声明、会话管理，并暴露多种传输能力（以 stdio 为主）。
  • 关键点与注意
    • MCP 的核心职责已在代码中实现：资源、工具、提示模板的暴露以及会话管理等。
    • 运行环境需要 Node.js、以及 MCP 客户端支持的运行时依赖（若有扩展的工具/插件）。
    • 客户端配置示例仅作说明，实际参数需结合具体运行环境与部署路径进行调整。
  • 相关参考
    • MCP 服务器暴露的工具集包括：conductor_dispatch、conductor_list_sessions、conductor_session_status、conductor_list_projects、conductor_kill_session。
    • 暴露的资源包括：conductor://projects、conductor://sessions。

服务器信息

访问项目