Overture MCP Server

使用说明(Markdown格式)

  1. 项目简介
  • Over­ture 是一个完整的 MCP 服务器端实现,能够托管资源、注册并执行工具、渲染及返回 Prompt 模板信息,并通过 JSON-RPC 与 MCP 客户端通信。它还提供多项目支持、市场化的 MCP 服务器浏览与附加、以及历史记录与计划追踪等能力,旨在为 LLM 客户端提供安全、可扩展的上下文服务。
  1. 主要功能点
  • MCP 核心能力:资源托管与数据访问、工具注册与执行、Prompt 模板定义与渲染,并通过 JSON-RPC 与客户端交互。
  • 实时通讯与多传输:通过 WebSocket、StdIO、HTTP 等传输协议实现服务端与客户端的实时通信。
  • 计划与执行管理:支持计划的创建、审批、执行、暂停、重新运行、版本差异查看和历史恢复。
  • MCP 市场门户:内置 MCP Marketplace,方便浏览、附加和管理 MCP 服务器,以及按节点附加工具。
  • 多工作区/多项目:支持在同一实例中管理多个项目,具备 isolation、历史记录、以及跨项目的上下文管理能力。
  • 持久化与历史:计划历史、历史条目、局部持久化存储,便于断点续传和历史回放。
  • 客户端配置示例:提供与 MCP 服务器对接所需的客户端配置字段(如 command、args),便于在不同代理/IDE中接入。
  1. 安装与运行步骤
  • 克隆与安装依赖
    • 安装依赖并构建整套仓库:
      • 安装依赖
      • 构建所有包
  • 启动 MCP 服务器
    • 进入包目录并启动服务器(示例为服务器端包):
      • 进入 packages/mcp-server 并执行启动
    • 启动 UI(管理界面):
      • 进入 packages/ui 并执行开发服务器
  • 访问与连接
    • Web UI 通常在 http://localhost:3031 提供计划预览与执行控制
    • WebSocket 服务端口通常为 ws://localhost:3030,客户端可通过 MCP 配置连接
  • 配置示例(客户端配置不需要在服务器端展示,但客户端需要知道如何启动与连接)
    • MCP 客户端需要的最小启动信息(以 JSON 表示,供客户端配置使用): { "serverName": "overture", "command": "npx", "args": ["overture-mcp"] }
  1. 服务器配置(MCP 客户端对接所需信息,按仓库信息生成准确的配置)
  • serverName: overture
  • command: npx
  • args: ["overture-mcp"]
  • 说明:这是 MCP 客户端在与 Over­ture MCP 服务器建立连接时需要的启动信息。客户端配置通常放在相关代理/IDE 的 MCP 设置里,不需要在服务器端代码中出现。
  1. 基本使用方法
  • 启动与接入
    • 启动后,MCP 客户端(如 Claude Code、Cursor、Cline、Copilot 等)通过指定的 serverName 连接到 Over­ture MCP 服务器,使用提供的 command 与 args 启动服务器并建立连接。
  • 使用流程
    • 客户端把计划(Plan)发送给服务器,服务器返回计划状态、执行进度以及必要的上下文信息。
    • 用户通过 UI/CLI 审批计划,服务器据此执行节点,返回执行输出和可能的结构化输出。
    • 支持多项目并行工作、节点级 MCP 服务器附加、以及计划历史的回放和对比。
  • 安全与扩展
    • 服务器端负责会话管理、能力声明,以及对传入请求的验证和权限控制,确保多方协作中的安全性与可扩展性。
  1. 特色与定位
  • 内置 MCP 市场与工具市场:允许在 UI 中直接浏览并附加 MCP 服务器到具体节点。
  • 多项目工作流:实现跨项目的计划管理、历史、与状态同步。
  • 强化的可视化与输出:支持结构化输出、变更差异视图,以及执行过程的实时反馈。
  1. 备注
  • Over­ture 的 MCP 服务端实现设计明确对接 MCP 客户端,具备完整服务器端能力、可运行的服务端代码,以及清晰的使用与接入说明,适合作为 AI 编码代理生态中的标准上下文服务入口。

服务器信息