Code Reasoning MCP Server

Servidor MCP de razonamiento de código

Un servidor de Protocolo de Contexto de Modelo (MCP) que mejora la capacidad de Claude para resolver tareas de programación complejas a través del pensamiento estructurado, paso a paso.

Instalación rápida

1. Configure Claude Desktop editando:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
   { "mcpServers": { "code-reasoning": { "command": "npx", "args": ["-y", "@mettamatt/code-reasoning"] } } }
2. Configurar VS Code:

Uso

1. Para activar este MCP, agregue lo siguiente a sus mensajes de chat:
   Use sequential thinking to reason about this.
2. Utilice indicaciones listas para usar que activen el razonamiento de código:

• Haga clic en el ícono "+" en la ventana de chat de Claude Desktop o, en Claude Code, escriba /help para ver los comandos específicos.
• Seleccione "Agregar desde Razonamiento de código" de las herramientas disponibles
• Elija una plantilla de solicitud y complete la información requerida
• Envíe el formulario para agregar el mensaje a su mensaje de chat y presione Enter.

Consulte la Guía de indicaciones para obtener detalles sobre el uso de las plantillas de indicaciones.

Opciones de línea de comandos

• --debug : Habilitar el registro detallado
• --help o -h : Mostrar información de ayuda

Características principales

• Enfoque de programación : Optimizado para tareas de codificación y resolución de problemas.
• Pensamiento estructurado : Dividir problemas complejos en pasos manejables
• Ramificación del pensamiento : explorar múltiples caminos de solución en paralelo
• Revisión del pensamiento : refinar el razonamiento anterior a medida que mejora la comprensión
• Límites de seguridad : se detiene automáticamente después de 20 pasos de reflexión para evitar bucles
• Avisos listos para usar : plantillas predefinidas para tareas de desarrollo comunes

Documentación

Documentación detallada disponible en el directorio docs:

• Ejemplos de uso : Ejemplos de pensamiento secuencial con el servidor MCP
• Guía de configuración : Todas las opciones de configuración para el servidor MCP
• Guía de indicaciones : uso y personalización de indicaciones con el servidor MCP
• Marco de pruebas : información de pruebas

Estructura del proyecto

Evaluación rápida

El servidor MCP de razonamiento de código incluye un sistema de evaluación de indicaciones que evalúa la capacidad de Claude para seguir las indicaciones de razonamiento de código. Este sistema permite:

• Probar diferentes variaciones de indicaciones frente a problemas de escenarios
• Verificación de la adherencia al formato de parámetros
• Puntuación de la calidad de la solución

Para utilizar el sistema de evaluación rápida, ejecute:

Comparación y desarrollo rápidos

Se dedicó un gran esfuerzo al desarrollo del indicador óptimo para el servidor de razonamiento de código. La implementación actual utiliza el indicador HYBRID_DESIGN, que resultó ganador en nuestro proceso de evaluación.

Comparamos cuatro diseños de indicaciones diferentes:

Nuestra evaluación en siete escenarios de programación diferentes mostró que HYBRID_DESIGN superó a otras indicaciones:

El mensaje HYBRID_DESIGN demostró, por un margen, la calidad de solución promedio más alta (86%) y el rendimiento más consistente en todos los escenarios, sin puntuaciones inferiores al 80%. También generó la mayor cantidad de reflexiones. El archivo src/server.ts se ha actualizado para utilizar este diseño óptimo de mensaje.

Personalmente, creo que la mayor mejora fue agregar esto al final del mensaje: "✍️ Termine cada pensamiento preguntando: "¿Qué me estoy perdiendo o necesito reconsiderar?"

Consulte el marco de pruebas para obtener más detalles sobre el sistema de evaluación rápida.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.