Deskaid

codemcp

Convierte a Claude Desktop en un asistente de programación en pareja instalando codemcp. Con él, puedes pedirle directamente a Claude que implemente funciones, corrija errores y refactorice código en tu computadora. Claude editará archivos y ejecutará pruebas directamente. ¡Olvídate de copiar código dentro y fuera de la ventana de chat de Claude!

codemcp ofrece una funcionalidad similar a otro software de codificación de IA (Claude Code, Cursor, Cline, Aider), pero ocupa un punto único en el espacio de diseño:

1. Está diseñado para usarse con Claude Pro , la suscripción de $20 al mes de Anthropic. Me gusta pagar por mi uso con un plan de suscripción porque significa cero costo marginal por las acciones del agente; se acabó la sensación de haber gastado cinco dólares en un conjunto de cambios que no funciona.Ten en cuenta que si tienes Claude Max (100 $/mes), Claude Code también se puede usar con suscripción. La propuesta de valor de codemcp es más confusa en este caso (y es definitivamente inferior a Claude Code en algunos aspectos), pero aún puedes usar codemcp con Claude Max si prefieres algunas de las otras opciones de interfaz de usuario que ofrece. (Además, es de código abierto, así que puedes modificarlo si no te gusta, a diferencia de Claude Code).
2. Está diseñado con autoaceptación por defecto . Quiero que mi agente llegue al máximo sin mi supervisión, para poder revisar todo de una vez al final. Hay dos aspectos clave que codemcp hace diferente a la mayoría de los agentes de codificación: prohibimos el shell sin restricciones , y en su lugar, exigimos que se declaren previamente los comandos que el agente puede usar en codemcp.toml , y versionamos en Git todas las ediciones LLM , para que se puedan revertir los cambios del agente de forma detallada y no haya que preocuparse por olvidar confirmar los cambios.
3. Es independiente del IDE : le pides a Claude que haga cambios, los realiza y luego puedes usar tu configuración de IDE favorita para revisarlos y realizar más modificaciones. Uso Vim como mi editor de controladores diario, y los entornos de programación que requieren VSCode o un editor específico me desaniman.

IMPORTANTE: Para usuarios maestros: Cambios importantes en la eficiencia del token

Para mejorar la eficiencia de los tokens de codemcp, en master estoy en proceso de convertir codemcp en una herramienta multiherramienta (en lugar de una sola herramienta cuyas instrucciones se envían al chat al iniciar el proyecto). Esto significa que debes aprobar manualmente el uso de la herramienta. Dado que la aprobación del uso de la herramienta es persistente en varios chats, creo que es una compensación razonable, pero si no te gusta, reporta un error en la extensión del navegador refined-claude para que admita la aprobación automática del uso de herramientas.

Instalación

Recomiendo esta forma específica de instalar y usar codemcp:

1. Instale uv e instale git, si aún no están instalados.
2. Instala claude-mcp en tu navegador. Esto te permite conectarte a los servidores SSE MCP directamente desde el sitio web, lo que significa que no necesitas usar Claude Desktop y puedes tener fácilmente varias ventanas de chat funcionando en paralelo. Esperamos que esta extensión quede obsoleta pronto con el lanzamiento de las Integraciones . Sin embargo, al momento de escribir este artículo, las Integraciones aún no están disponibles para los suscriptores de Claude Pro.
3. Ejecute codemcp con uvx --from git+https://github.com/ezyang/codemcp@prod codemcp serve . Puede agregar --port 1234 si necesita escuchar en un puerto no estándar.Consejo: si te gusta vivir al límite, puedes cambiar prod a main . Si quieres anclar a una versión específica, reemplázala por 0.3.0 o similar.Consejo: ¡Puedes ejecutar codemcp remotamente! Si usas Tailscale y confías en todos los dispositivos de tu Tailnet, puedes hacerlo de forma segura pasando --host 100.101.102.103 (reemplaza la IP con la dirección IP de Tailscale de tu nodo. Esta IP suele estar en el rango 100.64.0.0/10). ADVERTENCIA: Cualquier persona con acceso a este MCP puede ejecutar código arbitrario en tu ordenador; es extremadamente improbable que quieras enlazar a 0.0.0.0.
4. Configure claude-mcp con la URL: http://127.0.0.1:8000/sse (reemplace el puerto si es necesario).
5. Lamentablemente, la interfaz web muestra el icono del martillo de forma inconsistente. Sin embargo, puedes verificar que el servidor MCP funciona buscando "[MCP codemcp] Conexión SSE abierta" en la consola o preguntando a Claude qué herramientas tiene disponibles (debería indicar que hay herramientas de codemcp disponibles).

Si prefiere utilizar Claude Desktop o tiene necesidades inusuales, consulte INSTALL.md para obtener instrucciones de instalación para una variedad de situaciones no estándar.

Uso

Primero, debes crear un archivo codemcp.toml en el repositorio de Git en el que quieres trabajar. Si quieres que el agente pueda ejecutar tareas como el formateador o las pruebas, añade los comandos para ejecutarlos en la sección de comandos (nota: estos comandos deben configurar correctamente el entorno virtual que necesiten).

El comando format es especial; siempre se ejecuta después de cada edición de archivo.

A continuación, en Claude Desktop, recomendamos crear un Proyecto y ponerlo en las Instrucciones del Proyecto:

Donde $PROJECT_DIR es la ruta al proyecto en el que desea trabajar.

Luego, habla con Claude sobre los cambios que quieres hacer en el proyecto. Cada vez que codemcp modifique tu código, se generará una confirmación.

Para ver algunos ejemplos de transcripciones utilizando esta herramienta, consulte:

• Implementar una nueva función
• Arreglar pruebas fallidas
• Hacer una refactorización

codemcp generará una confirmación por chat y la modificará a medida que trabaje en su función.

Filosofía

• Cuando tengas un límite de velocidad, tómate el tiempo para hacer otra cosa (revisar el código de Claude, revisar el código de otra persona, hacer planes, realizar algunas reuniones).
• Este no es un agente autónomo. Como mínimo, debes intervenir después de cada chat para revisar los cambios y solicitar el siguiente. Aunque puedes solicitar una larga lista de tareas en un solo chat, es probable que alcances el límite de rendimiento de Claude Desktop y tengas que "continuar" el agente manualmente. Aprovéchalo y aprovecha las interrupciones para asegurarte de que Claude esté haciendo lo correcto.
• Cuando Claude se descarrila, te cuesta tiempo en lugar de dinero. Actúa en consecuencia: si el tiempo es el cuello de botella, vigila atentamente el rendimiento incremental de Claude.

Configuración

Aquí están todas las opciones de configuración admitidas por codemcp.toml :

El project_prompt se cargará cuando inicialice el proyecto en los chats.

La sección commands permite configurar comandos para herramientas específicas. Los nombres se le indican al LLM, quien decide cuándo ejecutarlos. Puede agregar instrucciones sobre el uso de las herramientas en el ` project_prompt ; también se admite una sintaxis más detallada que permite dar instrucciones específicas para cada herramienta:

Solución de problemas

Para ejecutar el servidor con el inspector, utilice:

Los registros se escriben en ~/.codemcp/codemcp.log . El nivel de registro se puede configurar en un archivo de configuración global en ~/.codemcprc :

El registro no se puede configurar por proyecto, pero esto no debería importar mucho porque de todos modos es difícil usar Claude Desktop en paralelo en varios proyectos.

Contribuyendo

Consulte CONTRIBUTING.md .