Coding Tools MCP

Inglés | 简体中文

Dale a cualquier chat o agente de IA un par de manos seguras sobre tu base de código.

Coding Tools MCP es un entorno de ejecución de codificación neutral respecto al modelo servido a través del Model Context Protocol: lectura y búsqueda de archivos, parches estructurados de múltiples archivos, ejecución de comandos, sesiones interactivas y git — un único servidor que cualquier cliente MCP puede manejar. Claude Desktop, Claude Code, Codex, Cursor, Cline, VS Code, Windsurf, Gemini CLI o un agente que construyas tú mismo: todos obtienen las mismas 18 herramientas contrastadas en la práctica, confinadas a un único espacio de trabajo y controladas por modos de permiso.

Por qué la gente lo usa

• Convierte una aplicación de chat en un agente de codificación. Claude Desktop — o cualquier cliente de chat MCP — obtiene acceso real al repositorio con la suscripción que ya tienes. No hace falta ningún producto adicional.

• La seguridad es el producto, no un añadido posterior. Una única raíz de espacio de trabajo por servidor. Las rutas absolutas, el ascenso con .. y las fugas por enlaces simbólicos se rechazan. Los modos de permiso regulan el acceso a la red, la expansión de la shell, los scripts integrados y los comandos destructivos. En Linux, Landlock añade confinamiento del sistema de archivos a nivel de kernel.

• Es independiente del modelo y del proveedor. Un catálogo fijo y fielmente anotado: sin cambiar de perfiles, sin juegos de anotaciones. Cambia de modelo o de cliente libremente; el runtime y su comportamiento se mantienen.

• Está diseñado para las ventanas de contexto. Los resultados se resumen, paginan y limitan por diseño; los bytes serializados de los resultados de las herramientas cayeron un 37% entre versiones en la carga de trabajo determinista (dogfood), manteniendo la finalización de las tareas sin cambios.

Related MCP server: chatgpt-codex-tools-mcp

Inicio rápido

Ejecútalo con la herramienta que ya tengas (el servidor es Python ≥ 3.11, desde PyPI; el paquete npm es un lanzador fino que lo inicia mediante uv o pipx):

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

Conéctalab a Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI o Cline — el JSON es el mismo en todas partes (cambia uvx por npx si prefieres Node):

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

Después pídele a tu cliente: «ejecuta la suite de pruebas y arregla el primer fallo».

¿Prefieres HTTP? Quita --stdio y el servidor hablará Streamable HTTP en http://127.0.0.1:8765/mcp. Ambas generaciones de protocolo se sirven en cualquiera de los dos transportes: la MCP 2026-07-28 en su totalidad, con tools como única capacidad anunciada, y la de la era del handshake 2025-11-25 con compatibilidad con 2025-06-18. Ninguna tiene sesiones. Un instalador de una línea, guías paso a paso por cliente y resolución de problemas en docs/quickstart.md y docs/mcp-client-config.md.

Siete cosas que probar

1. Convierte Claude Desktop en tu agente de codificación. Con la configuración anterior es suficiente: la ventana de chat por la que ya pagas puede ahora leer, parchear, probar y revisar commits de un repositorio real.

2. Codifica en tu propia máquina desde cualquier lugar.

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

Enlace de loopback + túnel HTTPS autenticado (cloudflared, ngrok o Microsoft Dev Tunnel). Apunta a claude.ai en tu teléfono hacia https://<tunnel-host>/mcp y controla tu ordenador de casa desde cualquier parte. ChatGPT y Grok se conectan de la misma manera desde su configuración de conectores. Los tokens Bearer y OAuth 2.1 + PKCE (con registro dinámico según RFC 7591) están integrados. → docs/remote-mcp.md

3. Deja que un agente operé sobre código no confidable, dentro de un sandbox desechable.

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

Un servidor containerizado con el marketplace de toolchains y cachés ya configurados, listo para apuntarlo a una Pull Request dudosa y destruirlo después. → docs/docker.md

4. Levanta un sandbox en la nube con una sola llamada MCP. El plano de control de Cloudflare Worker incluido expone start_coding_tools_sandbox como una herramienta MCP: una sola llamada lanza un runner de GitHub Actions que arranca el sandbox de Docker y lo publica detrás de un túnel Cloudflare autenticado. Cómputo efímero, sin un servidor tuyo.

5. Condúcelo desde una interfaz gráfica.

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

Perfiles por espacio de trabajo, arranque/parada del servidor y del túnel, configuración de credenciales con asistentes de portapapeles y comprobaciones de salud en vivo. Inglés y 简体中文.

6. Mantén vivo un comando interactivo. exec_command levanta un REPL o un depurador bajo un PTY real; write_stdin lo alimenta entre turns; read_output pagina la salida larga; kill_command cierra los procesos. Los procesos de larga duración son ciudadanos de primera clase, con guardias de plazo y búferes limitados.

7. Dale a tu propio agente manos de nivel de producción. ¿Estás construyendo un agente con el SDK de Anthropic u otra herramienta? No malgastes hacer a mano tus herramientas para archivos y ejecución — habla MCP con este servidor y hereda todo el perímetro de seguridad. → docs/embedding.md

En el catálogo de herramientas

No hay más que una serie estable, fielmente anotada. Los modos de permiso cambian la política de comandos, nunca las herramientas que ve el modelo. apply_patch es la única primitiva de modificación de ficheros: en etapas, validada contra la línea base, atómica a través de archivos y reversible.

Los archivos raíz AGENTS.md/CLAUDE.md se cargan automáticamente y se incluyen en instructions de initialize, o de server/discover para un cliente que no hace handshake. El content de una herramienta es texto conciso orientado al agente; in structuredContent encuentra el resultado completo y la estructura de la máquina. Consulta en docs/tools-and-schemas.md · docs/runtime-contract-v0.3.md.

Límites de seguridad

El listado recursivo y la búsqueda excluyen .git, node_modules, outputs de build, venvs y cachés. Los comandos se ejecutan con el directorio de trabajo ceñido al espacio de trabajo, entorno sanitizado, tiempos de expiración y límites de salida. En hosts Linux con Landlock se obtiene confinamiento del sistema de archivos por kernel; otras plataformas reciben aviso explícito de que esto no es un sandbox completo del SO, así que para tareas verdaderamente no una details: SECURITY.md · docs/security-boundary.md · docs/permission-modes.md

Telemetría

El servidor envía telemetría de uso médica en anónima (contadores de éxito/latencia por herramienta y dimensiones de versión/plataforma — nunca rutas, argumentos, comandos, ni contenidos de archivos) para priorizar correcciones. Desactivalo con CODING_TOOLS_ST_TELEMETRY=off o DO_NOT_TRACK=1; en CI se desactiva automáticamente. CODING_TOOLS_MCP_TELEMETRY=debug imprime cada evento en stderr en lugar de enviarlo. La lista completa de eventos y las garantías detallan en docs/telemetry.md.

Evidencia, dogfood y SWE-bench

Cada publicación se realiza a través de un pipeline disparado por tag, en el que la suite de cumplimiento, el benchmark de carga real y el entorno de pruebas SWE-bench se ejecutan desde el mismo commit que publica en PyPI y npm: ambas con publicación de confianza, npm con provenance atético. Las métricas de eficiencia medioambiental en dog food son reproducibles (make dogfood-smoke) y están integradas en reports/. Esta repositorio no reclama un resultado domain de clasificación SWE-bench — así que en docs/swe-bench.md uso cómo se Aplico. Más: COMPLIANCE.md · BENCHMARK.md · docs/dogfood.md

Documentation

Desarrollo

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

La matriz completa de puertas está en docs/ci-and-tests.md.

Licencia

Este proyecto está licenciado bajo la Apache License 2.0.

Si usas código, documentación, secciones amplíamente de la implementación o trabajo derivado de este proyecto, conserva el aviso de copyright, el mensaje de licencia y el ficheroquíamiento NOTICE, y atribuye claramente al proyecto original.

Proyecto: Coding Tools MCP
Autor: Coding Tools MCP Contributors
Fuente: https://github.com/xyTom/coding-tools-mcp

Los metadatos de citación están disponibles en CITATION.cff.