mybolide/coding-tools-mcp

把本地项目变成 AI 可直接开发、能够跨会话延续上下文的持久工作区。
中文 · English · 下载最新版
Coding Tools MCP 是一个 Rust + Tauri 2 桌面应用。选择项目目录并启动服务后，AI Agent 就能通过 MCP 读取文件、修改代码、运行命令和测试、查看 Git 状态，并把关键进度保存为项目内的历史会话。它更接近“AI 打开一个会记住开发进度的 IDE 工作区”；普通开发工具不要求先创建 Task，历史会话则负责在新对话中恢复上下文。
一个桌面端同时管理工作区、MCP 服务、连接信息与会话恢复提示词。
## 30 秒看懂怎么用
text
下载安装桌面端
→ 添加项目目录
→ 启动 MCP 和公网隧道
→ 复制“公网 MCP 地址”
→ ChatGPT 开启开发人员模式
→ 新建 MCP 插件并粘贴地址
→ 完成授权，在新对话中开始开发
第一次使用只需要记住两件事：桌面端负责把项目变成 MCP 工作区，ChatGPT 负责通过公网 /mcp 地址连接它。
查看完整安装和桌面端启动步骤
直接查看 ChatGPT 插件配置
## 五分钟开始使用
### 1. 安装桌面客户端
打开 Releases 并下载对应安装包：
| 系统 | 安装包 |
| Windows 10/11 x64 | Coding.Tools.MCPx64-setup.exe |
| macOS Intel + Apple Silicon | Coding.Tools.MCPuniversal.dmg |
macOS 安装包使用 ad-hoc 签名。如果系统阻止首次打开，请右键「打开」，或在“系统设置 → 隐私与安全性”中确认打开。
> 工作区位于「文稿 / 桌面 / 下载」时，macOS 会要求授权一次；点「允许」后即持久生效。
> 若遇到反复弹窗，见 疑难解决方案。
### 2. 添加项目工作区
1. 点击左侧的“添加工作区”。
2. 选择项目根目录。
3. 设置工作区名称、MCP 端口和认证方式。
4. 保存后，工作区会长期保留在左侧列表中。
### 3. 配置公网隧道
如果 AI 客户端不在本机，需要把本地 MCP 暴露为 HTTPS 地址：
在“软件管理”中安装或识别 frpc / cloudflared。
在“FRP 配置”中保存服务器、端口和 Token，或在工作区选择 Cloudflare。
每个工作区填写独立子域名。应用会统一管理 FRP 进程和多条代理线路。
FRP 服务器配置集中保存，各工作区只需选择配置并填写自己的子域名。
如果还没有可用的 FRPS 服务端，可以参考：FRPS 服务端安装教程（微信公众号）。安装完成后，把服务端地址、端口和 Token 填入客户端的“FRP 配置”即可。
### 4. 启动 MCP
进入工作区并点击 MCP 的“启动”。客户端会显示：
本地 MCP 地址，例如 http://127.0.0.1:28766/mcp；
公网 HTTPS MCP 地址；
ChatGPT 连接所需的认证信息；
实时日志和健康检查结果。
启动后可以直接检查本地与公网端点、OAuth 元数据和 MCP 受保护资源：
健康检查会逐项显示连接和认证元数据是否可用。
遇到连接问题时，无需离开桌面端即可查看最近的 MCP 请求日志：
日志可快速确认工具列表、历史初始化和检查点调用是否真正到达服务端。
### 5. 连接 AI 客户端
支持 MCP 的客户端使用界面中的公网 MCP URL。使用 OAuth 时，客户端会通过服务端元数据进入授权流程；授权口令、Client ID 和 Secret 均可在桌面端集中生成和管理。当前版本使用预配置 OAuth 客户端，创建 ChatGPT 插件时应选择静态/手动 OAuth 凭据，不需要选择 CIMD。
首次连接建议先调用历史初始化，再检查工作区：
text
historysessionbootstrap
serverinfo
getdefaultcwd
gitstatus
checkexecenvironment
这样 Agent 不需要依赖聊天上下文猜测当前项目、工作目录和执行能力。
## ChatGPT 的两种接入方式
| 方式 | 适合场景 | 在客户端中使用什么 |
| MCP Connector | ChatGPT 直接使用文件、命令和 Git 工具 | 工作区的公网 /mcp 地址 |
| GPT Actions | 在自定义 GPT 中导入 OpenAPI 工具 | Actions 面板中的 /openapi.json 地址 |
### MCP Connector
配置前请先确认：
1. 工作区的 MCP 服务和公网隧道均处于运行状态。
2. “健康检查”中的公网 MCP 检查通过；如果使用 OAuth，再确认 OAuth 受保护资源和授权元数据检查通过。
3. 从桌面端“GPT 配置”卡片复制“公网 MCP 地址”；如果使用 OAuth，同时准备 OAuth Client ID、OAuth Client Secret 和授权口令。
> ChatGPT 必须使用公网 HTTPS /mcp 地址，不能使用 http://127.0.0.1:28766/mcp 之类的本地地址。ChatGPT 的菜单名称可能随版本和语言设置略有变化。
#### 1. 开启 ChatGPT 开发人员模式
打开 ChatGPT 设置，进入“账户安全与登录”，开启“开发人员模式”。该开关允许添加未经验证的 MCP 连接器。
开发人员模式具有较高权限，只应连接你自己部署或明确可信的 MCP 服务。
#### 2. 创建 MCP 插件
在 ChatGPT 左侧进入“插件”，点击右上角的 + 新建插件，然后选择 MCP（测试版）并填写：
| ChatGPT 字段 | 填写内容 |
| 名称 | 自定义一个容易识别的名称，例如 Coding Tools MCP |
| 描述 | 简要说明它连接的项目或用途 |
| 连接 | 粘贴桌面端“GPT 配置”中的公网 MCP 地址，URL 应以 /mcp 结尾 |
| 身份验证 | 与桌面端保持一致；截图以 OAuth 为例 |
使用 OAuth 时，展开“高级 OAuth 设置”，选择静态/手动 OAuth 凭据并填写桌面端提供的 Client ID 和 Client Secret，不需要选择 CIMD。保存或连接后，ChatGPT 会打开授权页面；输入桌面端“GPT 配置”卡片中的授权口令完成首次授权。
> Client Secret、授权口令和 Bearer Token 都属于敏感信息，不要粘贴到对话、Issue 或公开截图中。若桌面端使用 Bearer 或不启用认证，请在 ChatGPT 中选择当前界面提供的对应认证方式。
#### 3. 验证连接
创建一个启用了该插件的新对话，并发送：
text
请使用 Coding Tools MCP 调用 serverinfo、getdefaultcwd 和 gitstatus，
告诉我当前连接的工作区、默认目录和 Git 状态。
如果能够返回当前项目的信息，说明“桌面端 → 公网隧道 → OAuth → ChatGPT → MCP 工具”链路已经打通。首次正式开发时，再调用 historysessionbootstrap 初始化或恢复项目历史。
如果 ChatGPT 仍显示旧的工具列表，请断开并重新连接插件，或创建一个新对话后再次验证。
#### 常见问题
| 现象 | 优先检查 |
| ChatGPT 无法连接 | 是否使用公网 HTTPS /mcp 地址，而不是 127.0.0.1；桌面端公网 MCP 健康检查是否通过 |