Claude Code MCP Enhanced

🤖 Servidor MCP de Claude Code

¿Quieres empezar rápido? ¡Consulta nuestra guía QUICKSTART.md !

Este proyecto es una bifurcación de steipete/claude-code-mcp con capacidades de orquestación mejoradas, mejoras de confiabilidad y documentación adicional.

Un servidor mejorado del Protocolo de Contexto de Modelo (MCP) que permite ejecutar Claude Code en modo de una sola ejecución con permisos omitidos automáticamente. Este servidor incluye capacidades avanzadas de orquestación de tareas, gestión robusta de errores y un patrón "boomerang" para dividir tareas complejas en subtareas manejables.

¿Has notado que los asistentes de IA estándar a veces tienen dificultades con ediciones u operaciones complejas de varios pasos? Este servidor, con su potente herramienta unificada claude_code y funciones de fiabilidad mejoradas, 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 potentes herramientas 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
• Ejecute operaciones complejas de varios pasos con manejo robusto de errores y reintentos
• Orqueste tareas a través de roles de agentes especializados utilizando el patrón boomerang
• Mantener una ejecución confiable a través de mecanismos de latido para evitar tiempos de espera

✨ Beneficios

• Mayor confiabilidad: manejo robusto de errores, reintentos automáticos, apagado ordenado y seguimiento de solicitudes
• Orquestación de tareas: los flujos de trabajo complejos se pueden dividir en subtareas especializadas
• Automatización de tareas: Convierta automáticamente listas de tareas de Markdown legibles por humanos en comandos MCP ejecutables
• Optimización del rendimiento: ejecución mejorada con almacenamiento en caché de configuración y eficiencia de recursos
• Mejor monitoreo: API de verificación de estado, informes de errores detallados y registro completo
• Experiencia del desarrollador: recarga en caliente de la configuración, controles de entorno flexibles y API simplificada

Además de todos los beneficios estándar de Claude Code:

• 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.
• Las operaciones con archivos, Git u otras no requieren modelos costosos. Claude Code es rentable si te suscribes a Anthropic Max.
• Claude tiene un acceso más amplio al sistema, por lo que cuando los asistentes estándar están bloqueados, simplemente pídales que "usen el código Claude" para desbloquear el progreso.

📝 Requisitos previos

• 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 .

💾 Instalación y uso

Puede instalar y utilizar este servidor MCP de tres maneras diferentes:

Método 1: A través de la URL de GitHub (recomendado)

El método más flexible es instalarlo directamente desde GitHub con npx . Esto siempre recupera la última versión del repositorio.

Agregue lo siguiente a su archivo .mcp.json :

📦 Método 2: A través del paquete npm

Si el paquete está publicado en npm, puedes instalarlo usando el nombre del paquete npm:

🔧 Método 3: Instalación local

Para fines de desarrollo o prueba, puede ejecutar el servidor desde una instalación local:

1. Clonar el repositorio:
   git clone https://github.com/grahama1970/claude-code-mcp-enhanced.git cd claude-code-mcp-enhanced
2. Instalar dependencias y compilar:
   npm install npm run build
3. Configure su archivo .mcp.json para usar el servidor local:

🔑 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 varios permisos de carpeta la primera vez que se ejecuta la herramienta, y la primera ejecución podría fallar. Las ejecuciones posteriores funcionarán con normalidad.

🔗 Conexión a su cliente MCP

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

Ejemplo de archivo de configuración MCP

A continuación se muestra un ejemplo de cómo agregar el servidor MCP de Claude Code a su archivo .mcp.json :

Ubicaciones 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).

Crea este archivo si no existe.

🛠️ Herramientas proporcionadas

Este servidor expone tres herramientas principales:

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.
• workFolder (cadena, opcional): el directorio de trabajo para la ejecución de la CLI de Claude, necesario cuando se utilizan operaciones de archivo o se hace referencia a cualquier archivo.
• parentTaskId (cadena, opcional): ID de la tarea principal que creó esta tarea (para orquestación de tareas/boomerang).
• returnMode (cadena, opcional): Cómo se deben devolver los resultados: 'summary' (conciso) o 'full' (detallado). El valor predeterminado es 'full'.
• taskDescription (cadena, opcional): descripción breve de la tarea para una mejor organización y seguimiento en flujos de trabajo orquestados.
• mode (cadena, opcional): cuando MCP_USE_ROOMODES=verdadero, especifica el modo Roo a utilizar (por ejemplo, "modo boomerang", "codificador", "diseñador", etc.).

health 🩺

Devuelve el estado de salud, la información de la versión y la configuración actual del servidor MCP de Claude Code.

Ejemplo de solicitud de verificación de salud:

Ejemplo de respuesta:

convert_task_markdown 📋

Convierte archivos de tareas de Markdown al formato JSON compatible con Claude Code MCP.

Argumentos:

• markdownPath (cadena, obligatoria): ruta al archivo de tarea de markdown a convertir.
• outputPath (cadena, opcional): Ruta donde se guarda la salida JSON. Si no se proporciona, devuelve el JSON directamente.

Ejemplo de solicitud:

Ejemplos de escenarios de uso

1. Operación básica del código

Ejemplo de solicitud MCP:

2. Orquestación de tareas (patrón Boomerang)

Solicitud de tarea para padres:

Solicitud de subtarea (generada por el padre):

3. Solicitud de modo especializado

Ejemplo de uso del modo Roo:

Convertidor de tareas

El servidor MCP incluye un potente conversor de tareas que transforma automáticamente listas de tareas Markdown legibles por humanos en comandos MCP totalmente ejecutables. Este conversor inteligente acorta la distancia entre cómo los humanos conciben las tareas y cómo las ejecutan las máquinas.

Flujo de trabajo completo

Pasos del flujo de trabajo

1. El usuario agrega el MCP a su archivo de configuración
2. El usuario le pide a Claude : "Usa convert_task_markdown para ejecutar mi archivo task.md".
3. El MCP automáticamente :
   • Carga el archivo markdown
   • Valida el formato (devuelve errores si faltan secciones)
   • Convierte tareas legibles para humanos en comandos ejecutables exactos
   • Devuelve JSON que Claude Code puede ejecutar secuencialmente
4. Claude recibe el JSON y puede ejecutar cada tarea utilizando la herramienta claude_code

Características principales

• Resolución automática de rutas: convierte instrucciones genéricas como "cambiar directorio al proyecto" en comandos ejecutables exactos con rutas completas
• Traducción inteligente de comandos: transforma las instrucciones en inglés en comandos de terminal precisos (por ejemplo, "activar el entorno virtual" → source .venv/bin/activate )
• Cumplimiento del protocolo MCP: garantiza que toda la salida sea 100 % compatible con el protocolo de contexto del modelo
• Sin ambigüedad: todos los comandos generados utilizan rutas exactas y sintaxis ejecutable, sin marcadores de posición ni referencias genéricas
• Validación de formato: aplica una estructura de rebajas adecuada y proporciona mensajes de error útiles para formatos incorrectos
• Actualizaciones de progreso en tiempo real: proporciona actualizaciones de progreso en vivo durante la conversión que muestran qué tareas se están procesando

Convertir tareas de Markdown en comandos MCP

La herramienta convert_task_markdown procesa archivos markdown estructurados y genera JSON compatible con MCP:

Formato de solicitud:

Formato de respuesta:

Formato de archivo de tarea de Markdown

Los archivos de rebajas de tareas deben seguir esta estructura:

El convertidor hará lo siguiente:

1. Analizar la estructura de Markdown
2. Extraer metadatos y requisitos de la tarea
3. Generar indicaciones detalladas para cada tarea de validación
4. Incluir la configuración del directorio de trabajo adecuado
5. Agregar resúmenes de verificación y finalización

Ejemplo de uso

1. Cree un archivo de tarea ( tasks/api_validation.md ):

2. Convertir a tareas MCP :

3. El convertidor muestra el progreso en tiempo real :
   [Progress] Loading task file... [Progress] Validating markdown structure... [Progress] Converting 27 validation tasks... [Progress] Task 1/27: Converting core/constants.py [Progress] Task 2/27: Converting core/arango_setup.py ... [Progress] Conversion complete!
4. El convertidor transforma instrucciones genéricas en comandos exactos :
   • "Cambiar directorio al proyecto y activar .venv" se convierte en:
     cd /home/user/project && source .venv/bin/activate
   • Todas las rutas se resuelven en rutas absolutas
   • Todos los comandos son completamente ejecutables sin ambigüedad.
5. Ejecutar las tareas convertidas : las tareas devueltas contienen comandos exactos y ejecutables, y pueden ejecutarse secuencialmente utilizando la herramienta claude_code .

Ejemplo completo: de Markdown a la ejecución

Paso 1: El usuario crea un archivo de tarea de Markdown ( project_tasks.md ):

Paso 2: El usuario le solicita a Claude :

Paso 3: MCP convierte y valida :

• Si el formato es correcto: Devuelve JSON ejecutable
• Si el formato es incorrecto: devuelve un error con instrucciones

Paso 4: Resultado (si tiene éxito) :

Paso 5: Claude puede ejecutar cada tarea secuencialmente

Validación de formato y manejo de errores

El convertidor de tareas aplica una estructura de Markdown específica para garantizar una conversión consistente y fiable. Si el archivo Markdown tiene un formato incorrecto, el convertidor muestra mensajes de error útiles:

Ejemplo de respuesta de error:

La validación asegura:

1. Las secciones obligatorias están presentes (Título, Objetivo, Requisitos)
2. Las tareas utilizan el formato de casilla de verificación adecuado
3. Cada tarea tiene pasos sangrados
4. Los requisitos utilizan el formato de casilla de verificación para mantener la coherencia

Patrones de orquestación de tareas

Este servidor MCP admite potentes capacidades de orquestación de tareas para gestionar flujos de trabajo complejos de manera eficiente.

Patrón de bumerán (Claude Desktop ⟷ Claude Code)

El patrón Boomerang permite a Claude Desktop orquestar tareas y delegarlas a Claude Code. Esto permite:

1. Divida los flujos de trabajo complejos en subtareas más pequeñas y manejables
2. Pasar contexto de las tareas principales a las subtareas
3. Obtener resultados de las subtareas a la tarea principal
4. Elija entre resultados detallados o resumidos
5. Realice un seguimiento y gestione el progreso mediante listas de tareas estructuradas

Visualización del patrón bumerán

Aquí hay un diagrama simple que muestra cómo Claude divide una tarea de receta en pasos y los delega a Claude Code:

En este ejemplo:

1. El usuario le pide a Claude que haga una receta de pastel de chocolate.
2. Claude (padre) divide esto en tareas separadas
3. Claude delega la tarea "Buscar receta" a Claude Code con un ID de tarea principal
4. Claude Code devuelve la información de la receta a Claude
5. Claude delega la tarea "Convertir medidas" a Claude Code
6. Claude Code devuelve las medidas convertidas
7. Claude combina todos los resultados y presenta la solución completa al usuario

Ejemplos de tareas sencillas:

Tarea 1: Encontrar la receta:

Tarea 2: Convertir medidas:

Cómo funciona

1. Creación de una subtarea:
   • Genere un ID de tarea único en su tarea principal
   • Envíe una solicitud a la herramienta claude_code con:
     • Su mensaje específico
     • El ID de la tarea principal
     • Una descripción de la tarea
     • El modo de retorno deseado ('resumen' o 'completo')
2. Recibiendo resultados:
   • El resultado de la subtarea incluirá un marcador especial: <!-- BOOMERANG_RESULT {...} -->
   • Este marcador contiene JSON con los metadatos de la tarea
   • La tarea principal puede analizar esto para identificar subtareas completadas
3. Ejemplo de flujo de trabajo con Claude Desktop:

Este enfoque es particularmente útil para tareas complejas que requieren un análisis profundo o múltiples pasos.

Ejemplo de gestión integral de listas de tareas

A continuación se muestra un ejemplo detallado del uso de Claude con Claude Code MCP para administrar y ejecutar una lista de tareas estructurada:

1. Configuración de la estructura de la lista de tareas

Primero, cree un archivo de lista de tareas (por ejemplo, tasks.md ) con la siguiente estructura:

2. Ejecución de la lista de tareas

Claude ahora puede trabajar sistemáticamente en las tareas utilizando el Código Claude:

3. Continuar con las tareas posteriores

Después de recibir la confirmación, Claude continuaría con la siguiente subtarea:

Este enfoque estructurado permite a Claude trabajar sistemáticamente con listas de tareas complejas y, al mismo tiempo, mantener una documentación clara del progreso, las suposiciones y los archivos relevantes durante todo el proceso.

Patrón de auto-orquestación (Claude Code como orquestador)

Aunque Claude Desktop se suele usar como agente principal, Claude Code puede utilizarse como orquestador y ejecutor. Este enfoque crea un sistema autónomo donde Claude Code gestiona su propia orquestación de tareas, sin necesidad de Claude Desktop.

Pasos de implementación

1. Cree un script de entrada que inicialice la estructura de su tarea e inicie Claude Code como orquestador
2. Diseñar una estructura de datos de tareas (normalmente en formato JSON) que rastree el estado y las dependencias de las tareas.
3. Cree scripts de ejecución de tareas para procesar tareas individuales y actualizar el estado de las tareas

Beneficios clave de la auto-orquestación

1. Autónomo : no requiere un orquestador externo (como Claude Desktop)
2. Estado persistente : toda la información de la tarea se almacena en archivos JSON
3. Recuperación de errores : puede reanudarse desde la última tarea exitosa si se interrumpe
4. Gestión de dependencias simplificada : un único sistema gestiona todas las interacciones de Claude Code
5. Automatización de scripts de shell : se integra fácilmente en pipelines de CI/CD o flujos de trabajo automatizados

Para obtener una guía de implementación detallada con ejemplos de scripts y estructuras de tareas, consulte Autoorquestación con Claude Code .

Integración de modos Roo

Este servidor MCP admite la integración con modos especializados mediante un archivo de configuración .roomodes . Al habilitarlo, puede especificar el modo que se usará para cada tarea, lo que permite un comportamiento especializado.

Cómo usar los modos Roo

1. Habilitar la compatibilidad con el modo Roo:
   • Establezca la variable de entorno MCP_USE_ROOMODES=true en su configuración de MCP
   • Cree un archivo .roomodes en el directorio raíz de su servidor MCP
   • Opcionalmente, habilite la recarga en caliente con MCP_WATCH_ROOMODES=true para recargar automáticamente la configuración cuando el archivo cambia
2. Configura tus modos:
   • El archivo .roomodes debe contener un objeto JSON con una matriz customModes
   • Cada modo debe tener un slug , name , roleDefinition y, opcionalmente, una apiConfiguration con un modelId
3. Usando un modo:
   • Al realizar solicitudes a la herramienta claude_code , incluya un parámetro mode con el slug del modo deseado
   • El servidor MCP aplicará automáticamente la definición de rol y la configuración del modelo.
4. Ejemplo de archivo .roomodes:
   { "customModes": [ { "slug": "coder", "name": "💻 Coder", "roleDefinition": "You are a coding specialist who writes clean, efficient code.", "apiConfiguration": { "modelId": "claude-3-sonnet-20240229" } }, { "slug": "designer", "name": "🎨 Designer", "roleDefinition": "You are a design specialist focused on UI/UX solutions." } ] }
5. Ejemplo de configuración del entorno:
   { "mcpServers": { "claude-code-mcp-enhanced": { "command": "npx", "args": ["github:grahama1970/claude-code-mcp-enhanced"], "env": { "MCP_USE_ROOMODES": "true", "MCP_WATCH_ROOMODES": "true", "MCP_CLAUDE_DEBUG": "false" } } } }
6. Realizar solicitudes con modos:
   { "toolName": "claude_code:claude_code", "arguments": { "prompt": "Your work folder is /path/to/project\n\nCreate unit tests for the user authentication module.", "workFolder": "/path/to/project", "mode": "coder" } }

Características principales de los modos Roo:

• Comportamientos especializados : los diferentes modos pueden tener diferentes indicaciones del sistema y configuraciones de modelo.
• Recarga en caliente : cuando MCP_WATCH_ROOMODES=true , el servidor recarga automáticamente la configuración cuando cambia el archivo .roomodes
• Rendimiento : El servidor almacena en caché la configuración de Roomodes para un mejor rendimiento
• Respaldo : si no se encuentra un modo o los modos de sala están deshabilitados, el servidor continúa con el comportamiento predeterminado

🛠️ Funciones de confiabilidad mejoradas

Este servidor incluye varias mejoras para mejorar la confiabilidad y el rendimiento:

1. Prevención de latidos cardíacos y tiempo de espera

Para evitar tiempos de espera del lado del cliente durante operaciones de larga duración:

• Se agregó un mecanismo de latido configurable que envía actualizaciones de progreso cada 15 segundos
• Se implementó el seguimiento y la generación de informes del tiempo de ejecución.
• Se agregaron parámetros de tiempo de espera configurables a través de variables de entorno

2. Manejo robusto de errores con reintentos

Se agregó lógica de reintento inteligente para errores transitorios:

• Se implementó el reintento automático con parámetros configurables
• Se agregó una clasificación de errores para identificar problemas que se pueden volver a intentar.
• Se crearon informes y seguimiento de errores detallados

3. Sistema de seguimiento de solicitudes

Se implementó una gestión integral del ciclo de vida de las solicitudes:

• Se agregaron identificaciones únicas para cada solicitud
• Se creó un seguimiento para las solicitudes en curso.
• Se aseguró una limpieza adecuada al finalizar o fallar.

4. Apagado elegante

Se agregó un manejo adecuado de la finalización del proceso:

• Manejadores de señales implementados para SIGINT y SIGTERM.
• Se agregó seguimiento para solicitudes en curso
• Se creó una lógica de espera para un apagado limpio
• Se aseguró una limpieza adecuada al salir

5. Almacenamiento en caché de configuración y recarga en caliente

Se agregó optimización del rendimiento para la configuración:

• Se implementó el almacenamiento en caché para el archivo Roomodes
• Se agregó invalidación automática basada en cambios de archivo
• Se creó un mecanismo de vigilancia de archivos configurable

⚙️ Opciones de configuración

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

Estos se pueden configurar en su entorno de shell o dentro del bloque env de la configuración de su servidor mcp.json .

Ejemplos visuales

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:

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.

Corrección del flujo de trabajo de acciones de GitHub

🎯 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."

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.
• Tiempos de espera del cliente: En operaciones de larga duración, el servidor envía mensajes de latido cada 15 segundos para evitar tiempos de espera del cliente. Si persisten los tiempos de espera, puede ajustar el intervalo de latido mediante la variable de entorno MCP_HEARTBEAT_INTERVAL_MS .
• Errores de red/servidor: El servidor ahora incluye lógica de reintento automático para errores transitorios. Si persisten los problemas, pruebe a aumentar los valores de MCP_MAX_RETRIES y MCP_RETRY_DELAY_MS .
• Advertencia de respaldo de la CLI de Claude: Si ve una advertencia sobre que la CLI de Claude no se encuentra en ~/.claude/local/claude, esto es normal. El servidor está recurriendo al comando claude de su PATH. Puede configurar la variable de entorno CLAUDE_CLI_PATH para especificar la ruta exacta a su ejecutable de la CLI de Claude si es necesario.

👨‍💻 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 .

💪 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)

💬 Comentarios y soporte

Si tiene algún problema o preguntas sobre el uso del servidor MCP de Claude Code, por favor:

1. Consulte la sección de solución de problemas más arriba
2. Enviar un problema en el repositorio de GitHub
3. Únase a la discusión en la sección de discusiones del repositorio

¡Agradecemos sus comentarios y contribuciones para mejorar esta herramienta!