MCP 桌面客户端

这是 coding-tools-mcp 的 Python 桌面客户端 MVP，核心目标是让研发同学用一个中文界面完成：

• 管理多个 Workspace
• 配置公网暴露地址，当前支持外部托管的 FRP 和由客户端管理的 Cloudflare
• 配置 OAuth / Bearer / NoAuth
• 启动和停止本地 MCP 运行时
• 查看运行日志和当前入口地址
• 直接复制 ChatGPT 自定义 MCP 应用需要填写的核心字段

运行

python -m pip install -e ".[desktop]"
coding-tools-mcp-desktop

也可以继续从源码直接运行：

python apps/desktop-client/main.py

依赖

• Python 3.11+
• PySide6
• psutil
• uvx 或 coding-tools-mcp 已在 PATH 中可用

语言

客户端首次启动时跟随系统语言，目前内置：

• English
• 简体中文

可以在左侧语言选择框中即时切换，选择结果会通过 Qt 设置持久化。系统语言不受支持时默认使用英文。

更新界面文本后，使用 PySide6 Linguist 工具刷新并检查翻译目录：

make desktop-i18n-update
make desktop-i18n-release
python scripts/check_desktop_i18n.py

ChatGPT 接入

当认证方式选择 oauth 后，界面里会直接展示并支持复制：

• 连接地址
• OAuth 客户端 ID
• OAuth 客户端密钥
• 授权口令

如果你使用 FRP，请把 Workspace、本地端口、FRP 子域名和服务器域名配好，复制界面生成的 FRP 片段，并在同一台主机上的 frpc 配置中应用它。桌面客户端只管理本地 MCP 运行时，不会替你启动或重载 frpc；界面显示的 FRP 公网地址也需要外部 frpc 正常运行后才可访问。

如果你使用 Cloudflare，有两种模式：

• 临时隧道：使用 cloudflared tunnel --url，启动后自动分配一个 trycloudflare.com 公网地址
• 固定域名：使用 Tunnel Token 启动命名隧道，并在界面里填写固定公网地址

当前限制

• FRP 当前是外部托管模式；客户端只生成配置片段，不管理 frpc 进程
• Ngrok、Dev Tunnel 还没有实现真实隧道启动能力
• Cloudflare 命名隧道模式依赖你提前在 Cloudflare 仪表盘里配置好 tunnel 和 hostname
• Cloudflare 命名隧道模式下，本地服务地址需要和 Cloudflare Tunnel 的 ingress 目标一致，通常是 http://127.0.0.1:<本地端口>