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 状态, 快照, 차이, 监听结果和项目记忆
확장	세션 建立时曝光 compact inventory,并通过统一 `skill_tool` / `mcp_tool` 按需 list, describe, call
유물	注册、列出和分页读取测试报告、构建产物、覆盖率和日志
스크린샷	截取显示器或屏幕区域,并通过 MCP ImageContent 返回
보안	OAuth, Bearer, 원격 세션 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}"
      }
    }
  }
}