Skip to main content
Glama
Code Reasoning MCP Server

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.

versión npm Licencia: MIT CI

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:

{
  "mcp": {
    "servers": {
      "code-reasoning": {
        "command": "npx",
        "args": ["-y", "@mettamatt/code-reasoning"]
      }
    }
  }
}

Related MCP server: Sequential Thinking MCP Server

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:

Indicaciones de 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:

Estructura del proyecto

├── index.ts                  # Entry point
├── src/                      # Implementation source files
└── test/                     # Testing framework

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:

npm run eval

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:

Diseño de avisos

Descripción

SECUENCIAL

El diseño original de la propuesta de pensamiento secuencial

POR DEFECTO

El mensaje de línea base utilizado anteriormente en el servidor

CÓDIGO_RAZONAMIENTO_0_30

Una variante experimental centrada en el razonamiento específico del código

DISEÑO HÍBRIDO

Un diseño refinado que incorpora los mejores elementos de otros enfoques.

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

Guión

DISEÑO HÍBRIDO

CÓDIGO_RAZONAMIENTO_0_30

POR DEFECTO

SECUENCIAL

Selección de algoritmos

87%

82%

88%

82%

Identificación de errores

87%

91%

88%

92%

Implementación en múltiples etapas

83%

67%

79%

82%

Análisis del diseño del sistema

82%

87%

78%

82%

Tarea de depuración de código

92%

87%

92%

92%

Optimización del compilador

83%

78%

67%

73%

Estrategia de caché

86%

88%

82%

87%

Promedio

86%

83%

82%

84%

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.

Available Tools

1 tool
code-reasoningA

🧠 Code Reasoning Tool (using sequential thinking)

Purpose → break complex problems into self-auditing, exploratory thought steps that can branch, revise, or back-track until a single, well-supported answer emerges.


WHEN TO CALL

• Multi-step planning, design, debugging, or open-ended analysis
• Whenever further private reasoning or hypothesis testing is required before replying to the user


ENCOURAGED PRACTICES

🔍 Question aggressively – ask "What am I missing?" after each step
🔄 Revise freely – mark is_revision=true even late in the chain
🌿 Branch often – explore plausible alternatives in parallel; you can merge or discard branches later
↩️ Back-track – if a path looks wrong, start a new branch from an earlier thought
❓ Admit uncertainty – explicitly note unknowns and schedule extra thoughts to resolve them


MUST DO

✅ Put every private reasoning step in thought
✅ Keep thought_number correct; update total_thoughts when scope changes
✅ Use is_revision & branch_from_thought/branch_id precisely
✅ Set next_thought_needed=false only when all open questions are resolved
✅ Abort and summarise if thought_number > 20


DO NOT

⛔️ Reveal the content of thought to the end-user
⛔️ Continue thinking once next_thought_needed=false
⛔️ Assume thoughts must proceed strictly linearly – branching is first-class


PARAMETER CHEAT-SHEET

• thought (string) – current reasoning step
• next_thought_needed (boolean) – request further thinking?
• thought_number (int ≥ 1) – 1-based counter
• total_thoughts (int ≥ 1) – mutable estimate
• is_revision, revises_thought (int) – mark corrections
• branch_from_thought, branch_id – manage alternative paths
• needs_more_thoughts (boolean) – optional hint that more thoughts may follow

All JSON keys must use lower_snake_case.


EXAMPLE ✔️

{
  "thought": "List solution candidates and pick the most promising",
  "thought_number": 1,
  "total_thoughts": 4,
  "next_thought_needed": true
}

EXAMPLE ✔️ (branching late)

{
  "thought": "Alternative approach: treat it as a graph-search problem",
  "thought_number": 6,
  "total_thoughts": 8,
  "branch_from_thought": 3,
  "branch_id": "B1",
  "next_thought_needed": true
}

Inputs: next_thought_needed (required), thought (required), thought_number (required), total_thoughts (required), +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion or overlap between tools. The single tool has a clearly defined purpose for code reasoning and problem-solving, so agents cannot misselect between multiple options.

    Naming Consistency5/5

    Since there is only one tool named 'code-reasoning', naming consistency is inherently perfect. There are no other tools to compare against, so no inconsistencies can exist in the tool set.

    Tool Count2/5

    A single tool for a 'Code Reasoning MCP Server' feels too minimal for the apparent scope. While the tool is feature-rich internally, the server's purpose suggests it should offer multiple specialized reasoning tools (e.g., for debugging, design, analysis) rather than one monolithic tool, making the count inappropriate.

    Completeness2/5

    The server claims to handle 'code reasoning' but provides only one general-purpose tool. This creates significant gaps: there are no specialized tools for different reasoning tasks (e.g., debugging vs. design), no tools for input/output handling, and no way to manage reasoning sessions independently, leading to potential agent failures in complex workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers