Coding Tools MCP

Coding Tools MCP — это настольное приложение на Rust + Tauri 2. После выбора каталога проекта и запуска службы ИИ-агент может через MCP читать файлы, изменять код, запускать команды и тесты, просматривать статус Git и сохранять ключевой прогресс в виде исторических сессий внутри проекта. Это ближе к «ИИ, открывающему рабочую область IDE, которая запоминает прогресс разработки»; обычные инструменты разработки не требуют предварительного создания Task, а исторические сессии отвечают за восстановление контекста в новых диалогах.

Один настольный клиент управляет рабочими областями, службой MCP, данными подключения и подсказками для восстановления сессий.

30 秒看懂怎么用

下载安装桌面端
  → 添加项目目录
  → 启动 MCP 和公网隧道
  → 复制“公网 MCP 地址”
  → ChatGPT 开启开发人员模式
  → 新建 MCP 插件并粘贴地址
  → 完成授权，在新对话中开始开发

При первом использовании нужно запомнить только две вещи: настольный клиент превращает проект в рабочую область MCP, а ChatGPT подключается к ней через публичный адрес /mcp.

• 查看完整安装和桌面端启动步骤

• 直接查看 ChatGPT 插件配置

五分钟开始使用

1. 安装桌面客户端

Откройте Releases и скачайте соответствующий установочный пакет:

Установочный пакет macOS в настоящее время не подписан. Если система блокирует первое открытие, подтвердите открытие в «Системные настройки → Конфиденциальность и безопасность».

2. 添加项目工作区

1. Нажмите «Добавить рабочую область» на левой панели.

2. Выберите корневой каталог проекта.

3. Задайте имя рабочей области, порт MCP и способ аутентификации.

4. После сохранения рабочая область останется в списке слева на постоянной основе.

3. 配置公网隧道

Если ИИ-клиент находится не на этом компьютере, необходимо предоставить локальный MCP как HTTPS-адрес:

• Установите или укажите frpc / cloudflared в «Управлении программным обеспечением».

• Сохраните сервер, порт и Token в «Конфигурации FRP» или выберите 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 используют публичный URL MCP из интерфейса. При использовании OAuth клиент проходит процедуру авторизации через метаданные сервера; код авторизации, Client ID и Secret можно централизованно генерировать и управлять ими в настольном клиенте. Текущая версия использует предварительно настроенный OAuth-клиент; при создании плагина ChatGPT следует выбирать статические/ручные учётные данные OAuth, выбирать CIMD не нужно.

При первом подключении рекомендуется сначала вызвать инициализацию истории, а затем проверить рабочую область:

history_session_bootstrap
server_info
get_default_cwd
git_status
check_exec_environment

Так агенту не придётся полагаться на контекст чата, чтобы угадывать текущий проект, рабочий каталог и возможности выполнения.

ChatGPT 的两种接入方式

MCP Connector

Перед настройкой убедитесь, что:

1. Служба MCP рабочей области и публичный туннель работают.

2. Проверка публичного MCP в «Проверке работоспособности» пройдена; при использовании OAuth также убедитесь, что проверка защищённых ресурсов OAuth и метаданных авторизации пройдена.

3. Скопируйте «Публичный адрес MCP» из карточки «Конфигурация GPT» настольного клиента; при использовании 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 (бета-версия) и заполните:

При использовании OAuth разверните «Расширенные настройки OAuth», выберите статические/ручные учётные данные OAuth и заполните Client ID и Client Secret, предоставленные настольным клиентом; выбирать CIMD не нужно. После сохранения или подключения ChatGPT откроет страницу авторизации; введите код авторизации из карточки «Конфигурация GPT» настольного клиента, чтобы завершить первую авторизацию.

Client Secret, код авторизации и Bearer Token — это конфиденциальная информация; не вставляйте их в диалоги, Issue или публичные скриншоты. Если настольный клиент использует Bearer или аутентификация отключена, выберите в ChatGPT соответствующий способ аутентификации из текущего интерфейса.

3. 验证连接

Создайте новый диалог с включённым этим плагином и отправьте:

请使用 Coding Tools MCP 调用 server_info、get_default_cwd 和 git_status，
告诉我当前连接的工作区、默认目录和 Git 状态。

Если удаётся получить информацию о текущем проекте, значит, цепочка «настольный клиент → публичный туннель → OAuth → ChatGPT → инструменты MCP» работает. Перед первой реальной разработкой вызовите history_session_bootstrap для инициализации или восстановления истории проекта.

Если ChatGPT по-прежнему показывает старый список инструментов, отключите и заново подключите плагин или создайте новый диалог и проверьте снова.

常见问题

GPT Actions

1. Запустите службу Actions рабочей области.

2. Скопируйте URL OpenAPI из панели Actions.

3. Импортируйте этот URL на странице Actions редактора GPT.

4. Выберите None, API Key или OAuth в соответствии с конфигурацией настольного клиента.

MCP и Actions могут работать одновременно для одной рабочей области, а также использовать разные порты и поддомены.

为什么需要它

• 面向真实开发：Файлы, команды, Git, тесты и длительные процессы находятся в одной Workspace.

• 跨会话持续开发：Новый диалог сначала получает ограниченное текущее состояние; когда нужен точный старый контекст, он находится по ключевым словам и читается из исходных архивов — не нужно повторно объяснять ИИ предысторию проекта и текущий прогресс.

• 进度可追溯：После каждого раунда задач можно сохранять структурированные контрольные точки; решения, изменения, результаты тестов и следующие шаги остаются в каталоге проекта.

• 多工作区管理：Один настольный клиент может хранить несколько проектов и управлять их MCP, Actions и публичными адресами.

• 连接 ChatGPT 更直接：Встроены Streamable HTTP, OAuth, Bearer Token, OpenAPI, FRP и Cloudflare-туннели.

• 默认工具面保持简单：Стабильные основные инструменты доступны по умолчанию, расширенные возможности Harness включаются по мере необходимости.

让项目记住每次对话

Обычные журналы чата подходят для просмотра содержания общения, но не подходят для долгосрочной передачи разработки. Coding Tools MCP записывает прогресс сессии в docs/history-session/ текущего проекта, позволяя контексту следовать за проектом, а не оставаться запертым в одном окне чата.

Скопируйте полную подсказку в новый диалог, чтобы инициализировать или восстановить историю; после каждого раунда задач сохраняйте контрольную точку.

Он предоставляет пять взаимодополняющих инструментов истории:

Типичный результат:

对话 1：分析项目 → 修改代码 → 运行测试 → 保存检查点
                                      ↓
对话 2：读取有界当前状态 → 搜索并精读需要的旧档案 → 从上次进度继续 → 保存新检查点

Исторические архивы используют читаемый формат Markdown, их можно включать в резервное копирование проекта или в Git, а также удобно просматривать и редактировать разработчику. memory/state.json — это ограниченная проекция текущего состояния, memory/manifest.json хранит только позиции, хэши и ключевые слова, не копируя основной текст; Markdown — это долгосрочный источник истины без потерь. Первый ввод и ввод каждого раунда должны передаваться ChatGPT как параметры инструмента initial_user_input, raw_user_input; сервер не может прочитать текст удалённого чата, который не был передан. Контрольные точки добавляются идемпотентно; при изменении содержимого одного turn_id сохраняются свидетельства revision и supersedes, и требуется подтверждение ok=true и совпадение цели сессии, прежде чем сохранение считается успешным.

Постоянное хранение истории выполняется ИИ через вызовы инструментов MCP, а не фоновой записью содержимого чата настольным клиентом. Если клиент не инициирует вызовы инструментов, сервер не может узнать о новых диалогах или прогрессе задач.

Agent 可以做什么

Профиль core по умолчанию предоставляет набор стабильных, комбинируемых инструментов разработки:

Типичный процесс разработки:

打开 Workspace
  → 理解项目和 Git 状态
  → 搜索并读取代码
  → 事务化应用 Patch
  → 运行命令和测试
  → 检查 diff 并提交

Расширенный профиль также сохраняет состояние проекта, журнал операций и другие возможности Harness, но обычное изменение файлов и выполнение команд не требует предварительного создания Task.

权限与恢复模型

Проект использует модель разрешений Workspace-first:

• Обычные файлы внутри Workspace можно читать, создавать, изменять, удалять и выполнять.

• Вне Workspace разрешён полный доступ только на чтение: read_file、list_dir、list_files、search_text、view_image.

• Запись, удаление и выполнение вне Workspace блокируются.

• .git и .github не могут быть повреждены обычными файловыми инструментами, Patch или командами интерпретатора.

• Patch выполняет предварительную проверку и восстановление при сбое в рамках одной операции; долгосрочное восстановление единообразно использует Git, без создания полного Workspace Snapshot.

Дочерние процессы Windows в настоящее время по-прежнему имеют границу выполнения policy_only; значение sandbox_enforced: false в ответе отражает реальное состояние. Статическая политика команд не эквивалентна полноценной файловой системе песочницы операционной системы.

本地开发

Требования к окружению: Node.js 20+, Rust stable, а также Tauri 2 prerequisites для текущей системы.

npm install
npm run desktop

Часто используемые команды проверки:

npm run check
npm run build
cd src-tauri && cargo test
cd src-tauri && cargo clippy --all-targets -- -D warnings

На Windows также можно дважды щёлкнуть dev-desktop.cmd. Не проверяйте настольное приложение только через npm run dev — оно запускает только Vite, но не оболочку Tauri.

项目结构

致谢

Благодарим сообщество Linux.do за продвижение проекта и обратную связь.

License

Apache-2.0