opentokenz/mcpx

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

424 stars 84 forks 品質 86 トレンド 34Apache-2.0

Repository Install

opentokenz/mcpxは、https://github.com/opentokenz/mcpx.からインポートされたMCPサーバー候補です。

概要

opentokenz/mcpxは、https://github.com/opentokenz/mcpx.からインポートされたMCPサーバー候補です。

概要（AI 翻訳）

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

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

能力概览

能力	说明
リモートセッション	持久化 Workspace 会话、角色权限、事件、接力和跨客户端恢复
ワークスペース	注册多个项目，并在创建会话时显式绑定项目根目录
出典	文件窗口、批量読み取り、搜索、文件列表和有界上下文;返回 SHA-256 与编码/换行元数据
編集	精确 replacement、批量变更、原子写、SHA 校验和格式保留
ターミナル	執行命令または项目 Task;短命令内联返回,长命令持久化为 Task
プロジェクトタスク	从项目配置中发现测试、构建和检查任务，并解析诊断信息
ワークスペース状態	读取 Git 状态、快照、差异、监听结果和项目记忆
拡張	Session 建立時曝光 compact inventory,并通过统一 `skill_tool` / `mcp_tool` 按需 list、describe、call
アーティファクト	注册、列出和分页读取测试报告、构建产物、覆盖率和日志
スクリーンショット	截取显示器或屏幕区域,并通过 MCP ImageContent 返回
セキュリティ	OAuth、Bearer、Remote Session ACL、命令/文書策略和語義確認
観察	通过本机 Socket 观察工具调用、Task、Edit 和操作事件

架构

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

公开工具

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

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
Project Task	从项目配置中发现测试、构建和检查任务，并解析诊断信息
Workspace State	读取 Git 状态、快照、差异、监听结果和项目记忆
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 --> Plans[Plan]
    Runtime --> Extension[Skill / Upstream MCP]
    Runtime --> Observe[Observation / Audit]

    Session --> Workspace[(Registered Workspace)]
    Tools --> Workspace
    Plans --> 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 的唯一权威来源。当前公开工具共 15 个，分为 12 个 core tools 和 3 个 support tools：

领域	工具	主要用途
Core	`workspace`	零参数列出已注册 Workspace，供建立会话前选择
Core	`session`	创建、恢复或关闭 Remote Session；省略 action 默认 open/resume
Core	`read`	读取、搜索、列举或组装 Workspace 源码上下文
Core	`edit`	创建、更新或重命名 Workspace 文件；使用 SHA revision guard 和幂等语义，不提供删除
Core	`move_out`	`prepare` 冻结明确的文件/目录/symlink manifest；用户确认后 `submit` 仅携带 `confirmation_uuid`
Core	`observe`	查看 session、Execution Task、Plan Task、history 或 logs；Workspace 静态内容使用 `read`
Core	`progress`	发布有业务意义的用户可见里程碑、等待、阻塞或失败状态
Core	`execute`	按策略执行命令或项目 Task，以及 attach、stop、stdin
Core	`plan`	create、read、advance、complete、block、replan、deliver 持久化计划
Core	`artifact`	产物登记、列表和分片读取
Core	`skill_tool`	Skill 生命周期唯一入口：`list`、`describe`、`call`；Runtime 内部管理 revision
Core	`mcp_tool`	MCP Server/Tool 唯一入口：`list`、`describe`、`call`；Runtime 内部管理 schema revision
Support	`runtime_read`	读取运行时能力、项目摘要或适用指令
Support	`screenshot_capture`	按明确 purpose 截取显示器或屏幕区域
Support	`secret_provide`	按明确 purpose 提供仅驻留内存的 Secret

GitHub で README 全文を見る

インストール

npx -y @modelcontextprotocol/server-github

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}