# Coding Tools MCP Windows 简易控制台

把 [xyTom/coding-tools-mcp](https://github.com/xyTom/coding-tools-mcp) 做成开箱即用的
Windows 桌面程序：不需要手动安装 Python、Node.js 或 Docker，也不必在黑色命令行窗口里管理服务。

![Windows 简易控制台](docs/images/windows-launcher.png)

## 下载

前往 [Releases](https://github.com/1510952971/coding-tools-mcp-windows/releases/latest)
下载 `CodingToolsMCP-Windows-x64.zip`，完整解压后双击 `CodingToolsMCP.exe`。

> 程序目前未购买商业代码签名证书。Windows SmartScreen 如果提示“未知发布者”，请先确认文件来自本仓库，
> 再选择“更多信息”→“仍要运行”。

## 三步开始

1. 选择允许 AI 操作的代码项目目录。
2. 保持“安全模式”，点击“启动服务”。
3. 选择 Codex、Claude、Cursor 或 Cline，点击“复制客户端配置”，粘贴到对应客户端。

默认 MCP 地址：

```text
http://127.0.0.1:8765/mcp
```

服务仅绑定本机 `127.0.0.1`，不会自动暴露到局域网或公网。

## 这是什么

Coding Tools MCP 是 AI 编程客户端的本地工具服务。连接后，AI 可以在你指定的项目范围内：

- 读取、搜索和修改文件；
- 应用结构化补丁；
- 运行命令、测试和构建任务；
- 管理交互式进程；
- 查看 Git 状态和历史。

它本身不是聊天软件。桌面控制台负责启动和管理 MCP 服务，Codex、Claude、Cursor、Cline
等客户端负责与 AI 对话并调用这些工具。

## Windows 版新增

- 中文图形界面，一键启动、停止和检测服务；
- 自动记住项目目录、端口、权限模式和客户端；
- 自动生成 Codex、Claude、Cursor、Cline 配置；
- 实时显示进程状态、服务健康状态和运行日志；
- 支持开机后手动打开即自动恢复服务、系统托盘驻留；
- 默认安全模式，并隐藏上游高风险 `dangerous` 模式；
- 自动清理无效或无权访问的 PATH 项，减少服务启动后意外退出；
- GitHub Actions 自动构建 Windows 发布包。

## 文档

- [Windows 完整操作手册](docs/WINDOWS_APP_GUIDE.zh-CN.md)
- [Windows 版快速说明](README-WINDOWS.zh-CN.md)
- [Windows v1.0 发布说明](docs/RELEASE_NOTES_WINDOWS_V1.zh-CN.md)
- [上游项目原始 README](README-UPSTREAM.md)
- [上游中文 README](README.zh-CN.md)

上游面向开发者和审计人员的资料仍完整保留，包括 Quickstart、Safety Boundary、Dogfood
和 SWE-bench；可从[上游项目原始 README](README-UPSTREAM.md)进入。

## 从源码构建

在 Windows PowerShell 中运行：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\build-windows-app.ps1
```

输出文件：

```text
dist\CodingToolsMCP\CodingToolsMCP.exe
dist\CodingToolsMCP-Windows-x64.zip
```

## 致谢与许可证

本项目基于 `xyTom/coding-tools-mcp` 二次开发，保留原项目版权声明、`NOTICE` 和
Apache License 2.0 许可证。Windows 简易控制台同样按仓库中的 [LICENSE](LICENSE) 发布。