Mcpx

MCPX

MCPX 是运行在本地开发环境中的 MCP Runtime（网关）。它通过 Streamable HTTP 把本地 Workspace、源码、变更、命令、任务、环境和扩展能力 安全地提供给 ChatGPT、Claude、Cursor、Grok 等 MCP 客户端。

MCPX 的重点不是增加一个聊天界面，而是提供一套可审计、可恢复、对模型友好 的开发工具协议：客户端可以跨连接恢复同一个 Remote Session，模型可以用文件 SHA、 Edit ID、Task ID 和能力版本避免重复读取和无效重试；Skill/MCP 的 revision 与 schema 一致性由 Runtime 内部管理。

能力概览

能力	说明
Remote Session	持久化 Workspace 会话、角色权限、事件、接力和跨客户端恢复
Workspace	注册多个项目，并在创建会话时显式绑定项目根目录
Source	文件窗口、批量读取、搜索、文件列表和有界上下文；返回 SHA-256 与编码/换行元数据
Edit	精确 replacement、批量变更、原子写、SHA 校验和格式保留
Terminal	执行命令或项目 Task；短命令内联返回，长命令持久化为 Task
Operation	并行或有依赖地执行多个公开工具，并统一等待、分页、取消和恢复
Project Task	从项目配置中发现测试、构建和检查任务，并解析诊断信息
Workspace State	读取 Git 状态、快照、差异、监听结果和项目记忆
Environment	查看操作系统、架构、Shell、容器、资源、文件系统和工具链
Extension	Session 建立时曝光 compact inventory，并通过统一 skill_tool / mcp_tool 按需 list、describe、call
Artifact	注册、列出和分页读取测试报告、构建产物、覆盖率和日志
Screenshot	截取显示器或屏幕区域，并通过 MCP ImageContent 返回
Security	OAuth、Bearer、Remote Session ACL、命令/文件策略和语义确认
Observation	通过本机 Socket 观察工具调用、Task、Edit 和操作事件

架构

flowchart LR
    Client[ChatGPT / Claude / Cursor / Grok] -->|Streamable HTTP /mcp| Runtime[MCPX Runtime]
    Runtime --> Session[Remote Session / ACL]
    Runtime --> Tools[Core & Support Tools]
    Runtime --> Orchestration[Operation / Plan]
    Runtime --> Extension[Skill / Upstream MCP]
    Runtime --> Observe[Observation / Audit]

    Session --> Workspace[(Registered Workspace)]
    Tools --> Workspace
    Orchestration --> Tools
    Extension --> Skills[Local Skills]
    Extension --> Upstream[Upstream MCP Servers]

    Runtime --> State[(SQLite State)]
    Observe --> State
    Tools --> RuntimeData[Task Logs / Artifacts / Snapshots]

MCPX 把客户端连接、持久化 Remote Session、Workspace 能力、执行编排和扩展发现放在同一个 Runtime 边界内；所有有状态操作都绑定 `remote_session_id`，并通过 SQLite、Task 日志、Artifact 与 Observation 保留可恢复和可审计的执行状态。

公开工具

`tools/list` 是工具名称、描述、参数 Schema 和 Annotation 的唯一权威来源。 当前公开