Claude Code MCP Server

Servidor MCP de Claude Code

Un servidor MCP (Protocolo de contexto de modelo) que permite ejecutar Claude Code en modo de una sola ejecución con permisos omitidos automáticamente.

¿Has notado que Cursor a veces tiene dificultades con ediciones u operaciones complejas de varios pasos? Este servidor, con su potente herramienta unificada claude_code , busca convertir a Claude en un agente más directo y eficaz para tus tareas de codificación.

Descripción general

Este servidor MCP proporciona una herramienta que los LLM pueden usar para interactuar con Claude Code. Al integrarse con Claude Desktop u otros clientes MCP, permite a los LLM:

• Ejecute Claude Code con todos los permisos omitido (usando --dangerously-skip-permissions )
• Ejecutar Claude Code con cualquier solicitud sin interrupciones de permisos
• Acceda directamente a las funciones de edición de archivos
• Habilitar herramientas específicas de forma predeterminada

Beneficios

• Claude/Windsurf suele tener problemas para editar archivos. Claude Code lo hace mejor y más rápido.
• Se pueden poner en cola varios comandos en lugar de ejecutarlos directamente. Esto ahorra espacio de contexto, lo que permite conservar la información más importante durante más tiempo y reducir las compactaciones.
• Las operaciones de archivos, Git u otras operaciones no requieren modelos costosos. Claude Code es bastante rentable si te suscribes a Antropic Max. Puedes usar Gemini u o3 en modo Max y ahorrar costos al transferir tareas a modelos más económicos.
• Claude tiene un acceso más amplio al sistema y puede hacer cosas que Cursor/Windsurf no pueden hacer (o creen que no pueden), así que cuando estén atascados simplemente pregúntales "usar código Claude" y generalmente los desbloqueará.
• Agentes en Reglas de agentes.

Prerrequisitos

• Node.js v20 o posterior (use fnm o nvm para instalar)
• Claude CLI instalado localmente (ejecútelo y llame a /doctor) y se aceptan -dangerously-skip-permissions .

Configuración

Variables de entorno

• CLAUDE_CLI_NAME : Anula el nombre del binario CLI de Claude o proporciona una ruta absoluta (predeterminado: claude ). Esto permite usar un binario CLI de Claude personalizado. Esto es útil para:
  • Uso de envoltorios CLI de Claude personalizados
  • Pruebas con binarios simulados
  • Ejecución simultánea de varias versiones de Claude CLI

  Formatos admitidos:

  • Nombre simple: CLAUDE_CLI_NAME=claude-custom o CLAUDE_CLI_NAME=claude-v2
  • Ruta absoluta: CLAUDE_CLI_NAME=/path/to/custom/claude

  Las rutas relativas (por ejemplo, ./claude o ../claude ) no están permitidas y generarán un error.

  Cuando se establece en un nombre simple, el servidor buscará el binario especificado en:

  1. La ruta del sistema (en lugar del comando claude predeterminado)

  Nota: La ruta de instalación del usuario local ( ~/.claude/local/claude ) seguirá estando verificada, pero solo para el binario claude predeterminado.

• MCP_CLAUDE_DEBUG : Habilitar el registro de depuración (establecer como true para una salida detallada)

Instalación y uso

La forma recomendada de utilizar este servidor es instalándolo mediante npx .

Para utilizar un nombre binario de Claude CLI personalizado, puede especificar la variable de entorno:

Configuración inicial importante: aceptar permisos

Antes de que el servidor MCP pueda utilizar con éxito la herramienta claude_code , primero debe ejecutar la CLI de Claude manualmente una vez con el indicador --dangerously-skip-permissions , iniciar sesión y aceptar los términos.

Este es un requisito único del Claude CLI.

Sigue las instrucciones para aceptar. Una vez hecho esto, el servidor MCP podrá usar la bandera de forma no interactiva.

macOS podría solicitar permisos de carpeta de todo tipo la primera vez que se ejecuta la herramienta y, posteriormente, falla. Las ejecuciones posteriores funcionarán.

Conexión a su cliente MCP

Después de configurar el servidor, debe configurar su cliente MCP (como Cursor u otros que usen mcp.json o mcp_config.json ).

Archivo de configuración de MCP

La configuración suele realizarse en un archivo JSON. El nombre y la ubicación pueden variar según el cliente.

Cursor

El cursor usa mcp.json .

• macOS: ~/.cursor/mcp.json
• Ventanas: %APPDATA%\\Cursor\\mcp.json
• Linux: ~/.config/cursor/mcp.json

Windsurf

Los usuarios de Windsurf utilizan mcp_config.json

• macOS: ~/.codeium/windsurf/mcp_config.json
• Ventanas: %APPDATA%\\Codeium\\windsurf\\mcp_config.json
• Linux: ~/.config/.codeium/windsurf/mcp_config.json

(Nota: en algunas configuraciones mixtas, si Cursor también está instalado, estos clientes pueden recurrir a la ruta ~/.cursor/mcp.json de Cursor. Priorice las rutas específicas de Codeium si usa la extensión Codeium).

Cree este archivo si no existe. Agregue o actualice la configuración de claude_code :

Herramientas proporcionadas

Este servidor expone una herramienta principal:

claude_code

Ejecuta un mensaje directamente usando la CLI de Claude Code con --dangerously-skip-permissions .

Argumentos:

• prompt (cadena, obligatorio): el mensaje que se enviará a Claude Code.
• options (objeto, opcional):
  • tools (matriz de cadenas, opcional): Herramientas específicas de Claude para habilitar (p. ej., Bash , Read , Write ). Las herramientas comunes están habilitadas por defecto.

Ejemplo de solicitud MCP:

Ejemplos

A continuación se muestran algunos ejemplos visuales del servidor en acción:

Reparación de la configuración de ESLint

A continuación se muestra un ejemplo del uso de la herramienta Claude Code MCP para corregir de forma interactiva una configuración de ESLint eliminando archivos de configuración antiguos y creando uno nuevo:

Ejemplo de listado de archivos

A continuación se muestra un ejemplo de la herramienta Claude Code que enumera archivos en un directorio:

Casos de uso clave

Este servidor, a través de su herramienta unificada claude_code , desbloquea una amplia gama de potentes capacidades al brindar a su IA acceso directo a la CLI de Claude Code. Estos son algunos ejemplos de lo que puede lograr:

1. Generación, análisis y refactorización de código:
   • "Generate a Python script to parse CSV data and output JSON."
   • "Analyze my_script.py for potential bugs and suggest improvements."
2. Operaciones del sistema de archivos (crear, leer, editar, administrar):
   • Creación de archivos: "Your work folder is /Users/steipete/my_project\n\nCreate a new file named 'config.yml' in the 'app/settings' directory with the following content:\nport: 8080\ndatabase: main_db"
   • Edición de archivos: "Your work folder is /Users/steipete/my_project\n\nEdit file 'public/css/style.css': Add a new CSS rule at the end to make all 'h2' elements have a 'color: navy'."
   • Mover/Copiar/Eliminar: "Your work folder is /Users/steipete/my_project\n\nMove the file 'report.docx' from the 'drafts' folder to the 'final_reports' folder and rename it to 'Q1_Report_Final.docx'."
3. Control de versiones (Git):
   • "Your work folder is /Users/steipete/my_project\n\n1. Stage the file 'src/main.java'.\n2. Commit the changes with the message 'feat: Implement user authentication'.\n3. Push the commit to the 'develop' branch on origin."
4. Ejecución de comandos de terminal:
   • "Your work folder is /Users/steipete/my_project/frontend\n\nRun the command 'npm run build'."
   • "Open the URL https://developer.mozilla.org in my default web browser."
5. Búsqueda web y resumen:
   • "Search the web for 'benefits of server-side rendering' and provide a concise summary."
6. Flujos de trabajo complejos de varios pasos:
   • Automatiza las actualizaciones de versiones, los registros de cambios y las etiquetas de lanzamiento: "Your work folder is /Users/steipete/my_project\n\nFollow these steps: 1. Update the version in package.json to 2.5.0. 2. Add a new section to CHANGELOG.md for version 2.5.0 with the heading '### Added' and list 'New feature X'. 3. Stage package.json and CHANGELOG.md. 4. Commit with message 'release: version 2.5.0'. 5. Push the commit. 6. Create and push a git tag v2.5.0."
7. Reparación de archivos con errores de sintaxis:
   • "Your work folder is /path/to/project\n\nThe file 'src/utils/parser.js' has syntax errors after a recent complex edit that broke its structure. Please analyze it, identify the syntax errors, and correct the file to make it valid JavaScript again, ensuring the original logic is preserved as much as possible."
8. Interactuar con GitHub (por ejemplo, crear una solicitud de extracción):
   • "Your work folder is /Users/steipete/my_project\n\nCreate a GitHub Pull Request in the repository 'owner/repo' from the 'feature-branch' to the 'main' branch. Title: 'feat: Implement new login flow'. Body: 'This PR adds a new and improved login experience for users.'"
9. Interactuar con GitHub (por ejemplo, comprobar el estado de PR CI):
   • "Your work folder is /Users/steipete/my_project\n\nCheck the status of CI checks for Pull Request #42 in the GitHub repository 'owner/repo'. Report if they have passed, failed, or are still running."

Corrección del flujo de trabajo de acciones de GitHub

Operaciones complejas de varios pasos

Este ejemplo ilustra cómo claude_code maneja una tarea más compleja de varios pasos, como preparar un lanzamiento creando una rama, actualizando múltiples archivos ( package.json , CHANGELOG.md ), confirmando cambios e iniciando una solicitud de extracción, todo dentro de una única operación coherente.

CRÍTICO: Recuerde proporcionar el contexto del Directorio de trabajo actual (CWD) en sus solicitudes para el sistema de archivos o las operaciones git (por ejemplo, "Your work folder is /path/to/project\n\n...your command..." ).

Solución de problemas

• "Comando no encontrado" (claude-code-mcp): Si se instala globalmente, asegúrese de que el directorio bin global de npm esté en la ruta de su sistema. Si usa npx , asegúrese de que npx funcione correctamente.
• "Comando no encontrado" (claude o ~/.claude/local/claude): Asegúrese de que la CLI de Claude esté instalada correctamente. Ejecute claude/doctor o consulte su documentación.
• Problemas de permisos: asegúrese de haber ejecutado el paso "Configuración inicial importante".
• Errores JSON del servidor: Si MCP_CLAUDE_DEBUG es true , los mensajes de error o registros podrían interferir con el análisis JSON de MCP. Establézcalo en false para un funcionamiento normal.
• Errores de importación/ESM: asegúrese de estar utilizando Node.js v20 o posterior.

Para desarrolladores: configuración local y contribución

Si desea desarrollar o contribuir a este servidor, o ejecutarlo desde un repositorio clonado para realizar pruebas, consulte nuestra Guía de configuración de desarrollo e instalación local .

Pruebas

El proyecto incluye conjuntos de pruebas completos:

Para obtener documentación de pruebas detallada, consulte nuestra Guía de pruebas E2E .

Configuración mediante variables de entorno

El comportamiento del servidor se puede personalizar utilizando estas variables de entorno:

• CLAUDE_CLI_PATH : Ruta absoluta al ejecutable de Claude CLI.
  • Predeterminado: verifica ~/.claude/local/claude y luego vuelve a claude (esperándolo en PATH).
• MCP_CLAUDE_DEBUG : Establézcalo como true para el registro de depuración detallado de este servidor MCP. Valor predeterminado: false .

Estos se pueden configurar en su entorno de shell o dentro del bloque env de su configuración de servidor mcp.json (aunque el bloque env en los ejemplos mcp.json se eliminó para simplificar, sigue siendo una forma válida de configurarlos para el proceso del servidor si es necesario).

Contribuyendo

¡Agradecemos sus contribuciones! Consulte la Guía de instalación y desarrollo local para obtener más información sobre cómo configurar su entorno.

Envíe problemas y solicitudes de extracción al repositorio de GitHub .

Licencia

Instituto Tecnológico de Massachusetts (MIT)