Proyecto claude-code-mcp

Actualizar

¡Ahora este servidor MCP funciona sin instalación local por npx!

Descripción general

El proyecto claude-code-mcp es un servidor MCP para Claude Code.

Llama al comando Claude Code instalado localmente y proporciona las siguientes herramientas: explain_code , review_code , fix_code , edit_code , test_code , simulate_command y your_own_query . El servidor se implementa con Node.js y el SDK de MCP, y recibe solicitudes en formato JSON de los clientes a través de stdio. Internamente, adopta la codificación Base64 para procesar con fluidez caracteres especiales (saltos de línea, comillas, etc.) en texto en lenguaje natural, lo que mejora la estabilidad y la flexibilidad. Sus funciones principales son recibir solicitudes, codificar la entrada, generar y ejecutar comandos, y devolver los resultados de la ejecución en formato JSON. Se ha confirmado que este proyecto funciona en entornos CLI de Claude Code (Ubuntu/WSL2, etc.).

💡 Host MCP con LLM menos potente, ¡puede dominar y usar el poder de Claude! 💪 ¡Con claude-code-mcp, también puedes llamar a Claude Code desde Claude Desktop! 😇😜😎 (sin confirmar)

Funciones

Las funciones principales del servidor son:

Recepción de solicitudes: recibe solicitudes de herramientas en formato JSON de los clientes (por ejemplo, code , context , focus_areas , etc.).
Procesamiento de entrada: codifica internamente en Base64 el texto en lenguaje natural recibido.
Selección de herramientas y generación de comandos: según el nombre de la herramienta en la solicitud, ensamble una cadena de comando para la consulta utilizando una plantilla fija o un formato libre ( your_own_query ).
Ejecución de comando: utilice child_process.spawn de Node.js para ejecutar el comando ensamblado y obtener el resultado de la salida estándar.
Resultado devuelto: devuelve el resultado de la ejecución al cliente en formato JSON.

Empezando

Prerrequisitos

Node.js (se recomienda >= v18, probado con v22.14.0)
npm (o hilo)
Comando Claude Code instalado y autenticación completada. https://docs.anthropic.com/es/docs/agents-and-tools/claude-code/overview

Instalación y uso

Hay varias formas de utilizar claude-code-mcp :

1. Uso de npx (recomendado para un uso rápido)

Puede ejecutar el servidor directamente sin instalación usando npx :

npx @kunihiros/claude-code-mcp

2. Instalación global

Instalar el paquete globalmente:

npm install -g claude-code-mcp

Luego puedes ejecutarlo como un comando:

claude-code-mcp

3. Instalación local (para desarrollo)

Clonar el repositorio e instalar las dependencias:

git clone https://github.com/KunihiroS/claude-code-mcp.git
cd claude-code-mcp/claude-code-server
npm install
npm run build

Luego puedes ejecutar el script creado directamente:

node build/index.js

Configuración

Variables de entorno:

Independientemente del método de instalación, debe configurar las variables de entorno. Cree uno de los siguientes archivos:

Uso de la configuración del host MCP (recomendado para npx ): Configure las variables de entorno directamente en la configuración de su host MCP (consulte "Configuración del host MCP" a continuación). Esta es la forma más sencilla de usar npx .
Usando un archivo .env : Crea un archivo .env en el directorio donde ejecutas el comando npx @kunihiros/claude-code-mcp .
Usando un archivo de configuración global: Cree un archivo .claude-code-mcp.env en su directorio de inicio ( ~/.claude-code-mcp.env ).

Si utiliza un archivo ( .env o ~/.claude-code-mcp.env ), agregue el siguiente contenido, ajustando la ruta CLAUDE_BIN :

# .env or ~/.claude-code-mcp.env
CLAUDE_BIN=/path/to/your/claude/executable  # REQUIRED: Set the full path to your Claude CLI
LOG_LEVEL=info                             # Optional: Set log level (e.g., debug, info, warn, error)

Configuración del host MCP (recomendado para npx ):

Agregue lo siguiente a la configuración de su aplicación MCP Host (p. ej., la configuración de Claude Desktop). Este método le permite configurar variables de entorno directamente.

    "claude-code-server": {
      "command": "npx",
      "args": [
        "-y",
        "@kunihiros/claude-code-mcp"
      ],
      "env": {
        "CLAUDE_BIN": "/path/to/your/claude/executable", // REQUIRED: Set the absolute path
        "LOG_LEVEL": "info"                             // Optional: Set log level
      },
      "disabled": false
    }

(Es posible que sea necesario reiniciar la aplicación host).

Configuración alternativa del host MCP (instalación global/desarrollo local):

Si instaló el paquete globalmente o lo está ejecutando localmente desde el repositorio clonado, y el comando claude-code-mcp está en la RUTA de su sistema, puede usar:

    "claude-code-server": {
      "command": "claude-code-mcp",
      "disabled": false
    }

En este caso, debe configurar las variables de entorno utilizando un archivo .env o el archivo global ~/.claude-code-mcp.env como se describe anteriormente.

Detalles de las variables de entorno

Este servidor utiliza las siguientes variables de entorno (establecidas a través de la configuración env del host MCP, .env o ~/.claude-code-mcp.env ):

CLAUDE_BIN : Especifica la ruta al ejecutable de la CLI de Claude. (Obligatorio) Ejemplo: /home/linuxbrew/.linuxbrew/bin/claude o C:\Users\YourUser\AppData\Local\bin\claude.exe
LOG_LEVEL : Especifica el nivel de registro. (Opcional, el valor predeterminado es info ). Valores posibles: debug , info , warn y error .

Herramientas disponibles

El servidor claude-code-mcp proporciona las siguientes herramientas:

explain_code : proporciona una explicación detallada del código dado.
review_code : revisa el código dado.
fix_code : corrige errores o problemas en el código dado.
edit_code : edita el código dado según las instrucciones.
test_code : genera pruebas para el código dado.
simulate_command : simula la ejecución de un comando dado.
your_own_query : envía una consulta personalizada con contexto.

Nota

Ubicación del archivo de registro ( claude-code-mcp.log ):
- Intenta crearlo primero en la raíz del proyecto.
- Regresa al directorio de inicio del usuario ( ~/.claude-code-mcp.log ).
- Finalmente, vuelve a /tmp/claude-code-mcp.log .
La rotación de registros aún no está implementada (tenga cuidado con el tamaño del archivo de registro).
Probado principalmente con Claude CLI en Ubuntu/WSL2.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte a continuación para obtener más detalles.

MIT License

Copyright (c) 2024 KunihiroS

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Descargo de responsabilidad

Este software se proporciona únicamente con fines educativos y de investigación. Este proyecto no está oficialmente asociado ni respaldado por Anthropic. Claude es una marca registrada de Anthropic.

El proyecto utiliza la CLI de Claude como dependencia, pero es un proyecto independiente impulsado por la comunidad. Los usuarios deben asegurarse de cumplir con los términos de servicio de Anthropic al utilizar este proyecto.

Los mantenedores de este proyecto no son responsables del mal uso del software ni de las violaciones de los términos de servicio de las API o servicios de terceros.

claude-code-mcp