Coding Tools MCP

English | 简体中文

Дайте любому AI-чату или агенту надёжные руки для работы с вашей кодовой базой.

Coding Tools MCP — это нейтральная к моделям среда выполнения для разработки, доступная через Model Context Protocol: чтение и поиск файлов, структурированные многофайловые патчи, выполнение команд, интерактивные сессии и git — один сервер, которым может управлять любой MCP-клиент. Claude Desktop, Claude Code, Codex, Cursor, Cline, VS Code, Windsurf, Gemini CLI или агент, которого вы собираете сами, — все получают один и тот же набор из 18 проверенных в деле инструментов, ограниченных одной рабочей областью и регулируемых режимами разрешений.

Почему люди это используют

• Превращает чат-приложение в кодинг-агента. Claude Desktop — или любой MCP-чат-клиент — получает реальный доступ к репозиторию с подпиской, которая у вас уже есть. Никакой лишний продукт не требуется.

• Безопасность — это продукт, а не довесок. Один корень рабочей области на сервер. Абсолютные пути, обход через .. и выходы через символические ссылки отклоняются. Режимы разрешений ограничивают сетевой доступ, подстановку в shell, встроенные скрипты и разрушительные команды. На Linux Landlock добавляет файловую изоляцию на уровне ядра.

• Он нейтрален к моделям и вендорам. Фиксированный, честно аннотированный каталог — без переключения профилей и игр с аннотациями. Модели и клиенты можно менять свободно; среда выполнения и её поведение остаются прежними.

• Он спроектирован с учётом контекстных окон. Результаты по замыслу сокращаются, разбиваются на страницы и ограничиваются по объёму; сериализованные байты результатов инструментов сократились на 37% от релиза к релизу на детерминированной dogfood-нагрузке при неизменном выполнении задач.

Related MCP server: chatgpt-codex-tools-mcp

Быстрый старт

Запустите его с тем инструментарием, что уже есть (сервер — это Python ≥ 3.11 из PyPI; npm-пакет — тонкий лаунчер, запускающий сервер через uv или pipx):

uvx coding-tools-mcp --stdio --workspace /path/to/repo   # Python toolchain
npx coding-tools-mcp --stdio --workspace /path/to/repo   # Node toolchain

Подключите его к Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI или Cline — конфигурация JSON везде одинакова (замените uvx на npx, если предпочитаете Node):

{
  "mcpServers": {
    "coding-tools": {
      "command": "uvx",
      "args": ["coding-tools-mcp", "--stdio", "--workspace", "/path/to/repo"]
    }
  }
}

Затем попросите клиента: «запусти тестовый набор и исправь первый сбой».

Предпочитаете HTTP? Уберите --stdio — и сервер будет общаться через Streamable HTTP на http://127.0.0.1:8765/mcp. Обе эпохи протокола работают на любом транспорте: MCP 2026-07-28 полностью, с tools как единственной заявляемой возможностью, и эпоха рукопожатия 2025-11-25 с совместимостью с 2025-06-18. Серве без сессий. Однострочный установщик, инструкции для клиентов и устранение неполадок — в docs/quickstart.md и docs/mcp-client-config.md.

Семь вещей, которые стоит попробовать

1. Превратите Claude Desktop в своего кодинг-агента. Приведённой выше конфигурации достаточно — окно чата, за которое вы уже платите, теперь может читать, патчить, тестировать и делать ревью коммcommit реального репозитория.

2. Пишите код на своей собственнойышейной из любой точки.

CODING_TOOLS_MCP_AUTH_MODE=bearer ./integrations/tunnels/tunnel.sh cloudflared /path/to/repo

Привязка loopback + аутентифицированный HTTPS-туннель (cloudflared, ngrok или Microsoft Dev Tunnel). Наведите claude.ai на телефоне на https://<tunnel-host>/mcp и управляйте своей домашней рабочей станцией откуда угодно. ChatGPT и Grok подключаются через свои настройки коннекторов по той же схеме. Встроены Bearer-токены и OAuth 2.1 + PKCE (с динамической регистрацией RFC 7591). → docs/remote-mcp.md

3. Выпустите агента на недоверенный код — внутри одноразовой песочницы.

docker build -t coding-tools-mcp-sandbox:local .
docker run --rm --init -it -p 8765:8765 -v "$PWD:/workspace" coding-tools-mcp-sandbox:local

Контейнеризованный сервер с предварительно настроенными инструментальными средствами и кэшами; безопасно нацеливать его на подозрительный PR и после удалить. → docs/docker.md

4. Поднимите облачную песочницу одним вызовом MCP. Встроенный Cloudflare Worker control plane предусмотрен start_coding_tools_sandbox как MCP-инструмент: один вызов отправляет GitHub Actions runner, который запускает Docker-песочницу и публикует её за аутентифицированным Cloudflare Tunnel. Временные вычисления, без собственного хостинга.

5. Управляйте им через GUI.

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

Профили на отдельном workspace, запуск/остановка серcеба и туннеля, настройка учётных данных с буфером обмена, live-проверки ресурса. Доступен English и 简体中文.

6. Держите интерактивную команду живой. exec_command запускает REPL или дебаггер под настоящим PTY; write_stdin отвечает ему между шагами; read_output постранично листает длинный вывод; kill_command завершает процесс. Долгоживущие процессы реализованы как полноправные, с watchdog дедлайнов и ограниченными буферами.

7. Дайте своему агенту руки уровня продакшна. Собираете агентный цикл на Anthropic SDK или на чём-то ещё? Не изобретайте вручную инструменты для файлов и exec — подключитесь к этому коду через MCP и унаследуйте всю границу защиты. → docs/embedding.md

Каталог инструментов

Один стабильный набор с честной аннотацией — режимы разрешений меняют пультику команды, но никогда не набор инструментов, которые видит модель. apply_patch единственный примитив изменения файлов: поэтапный, с контролью базовой версии, атомарный между файлами, с откатом.

Корневые AGENTS.md/CLAUDE.md подгружаются автоматически и возвращаются в поле instructions при initialize или в server/discover для клиента, который не выполняет рукопожатие. content инструмента — это короткий текст для агента; structuredContent несёт полный машинный результат. Схемы и структуры результатов: docs/tools-and-schemas.md · docs/runtime-contract-v0.3.md.

Граница безопасности

Рекурсивный обход и поиск исключают .git, node_modules, результаты сборки, virtualenv и кэши. Команды запускаются в рабочей области со сбросом окружения, таймаутами и лимитами вывода. Linux-хosts с Landlock получают файловую изоляцию на уровне ядра; на других плат форма предупреждение — это по-прежнему не полный изолированный песочница для невозможных задач, используйте Docker-образ или VM для по-настоящему недоверительного кода. Подробности: SECURITY.md · docs/security-boundary.md · docs/permission-modes.md

Телеметрия

Сервер отправляет анонимную телеметрию (счётчики успешности/латентности по инструментам и размеры версии/платформы — никто не срок, не передаются пути, аргументы, команды или содержимое файлов), чтобы помочь приоритизировать исправления. Отключить можно через CODING_TOOLS_MCP_TELEMETRY=off или DO_NOT_TRACK=1; в CI она автоматически выключена. CODING_TOOLS_MCP_TELEMETRY=debug вместо отправки печатает каждое событие в stderr. Полный список событий и гарантии — в docs/telemetry.md.

Evidence, Dogfood и SWE-bench

Каждый релиз проходит через пайплайн, запускаемый по тегу, где комплект compliance, реальный рабочий бенчмарк и SWE-bench инструмент собираются из коммита, который публикуется в PyPI и npm — оба через trusted publishing, npm — с provenance. Метрики эффективности dogfood воспроизводимы (команда make dogfood-smoke) и сохранёны в репозитории в reports/. Этот репозиторий не претендует на результаты модели в лиддерборde провёл SWE-bench — см. docs/swe-bench.md для точного описания того, что именно измеряется, а что нет. Ещё: COMPLIANCE.md · BENCHMARK.md · docs/dogfood.md

Документация

Разработка

python -m pip install -e ".[dev]"
make ci        # lint, typecheck, tests, protocol/integration suites, gates

Полная матрица гейтов — в docs/ci-and-tests.md.

Лицензия

Проект распространяется под лицензией Apache License 2.0.

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

Проект: Coding Tools MCP
Автор: Coding Tools MCP Contributors
Источник: https://github.com/xyTom/coding-tools-mcp

Метаданные цитирования доступны в CITATION.cff.