Skip to main content
Glama
Code Reasoning MCP Server

Code Reasoning MCP Server

Code Reasoning MCP-Server

Ein Model Context Protocol (MCP)-Server, der Claudes Fähigkeit verbessert, komplexe Programmieraufgaben durch strukturiertes, schrittweises Denken zu lösen.

npm-Version Lizenz: MIT CI

Schnelle Installation

  1. Konfigurieren Sie Claude Desktop durch Bearbeiten von:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    • Linux: ~/.config/Claude/claude_desktop_config.json

    {
      "mcpServers": {
        "code-reasoning": {
          "command": "npx",
          "args": ["-y", "@mettamatt/code-reasoning"]
        }
      }
    }
  2. VS Code konfigurieren:

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

Related MCP server: Sequential Thinking MCP Server

Verwendung

  1. Um dieses MCP auszulösen, hängen Sie Folgendes an Ihre Chat-Nachrichten an:

    Use sequential thinking to reason about this.
  2. Verwenden Sie sofort einsatzbereite Eingabeaufforderungen, die Code-Reasoning auslösen:

Eingabeaufforderungen zur Codebegründung

  • Klicken Sie im Chatfenster von Claude Desktop auf das Symbol „+“ oder geben Sie in Claude Code /help , um die spezifischen Befehle anzuzeigen.

  • Wählen Sie aus den verfügbaren Tools „Aus Code Reasoning hinzufügen“

  • Wählen Sie eine Eingabeaufforderungsvorlage und geben Sie die erforderlichen Informationen ein

  • Senden Sie das Formular, um die Eingabeaufforderung zu Ihrer Chat-Nachricht hinzuzufügen, und drücken Sie die Eingabetaste

Einzelheiten zur Verwendung der Eingabeaufforderungsvorlagen finden Sie im Eingabeaufforderungshandbuch .

Befehlszeilenoptionen

  • --debug : Detaillierte Protokollierung aktivieren

  • --help oder -h : Hilfeinformationen anzeigen

Hauptmerkmale

  • Programmierfokus : Optimiert für Codierungsaufgaben und Problemlösung

  • Strukturiertes Denken : Zerlegen Sie komplexe Probleme in überschaubare Schritte

  • Gedankenverzweigung : Erkunden Sie mehrere Lösungspfade parallel

  • Gedankenrevision : Verfeinern Sie frühere Überlegungen, wenn sich das Verständnis verbessert

  • Sicherheitsgrenzen : Stoppt automatisch nach 20 Denkschritten, um Schleifen zu vermeiden

  • Gebrauchsfertige Eingabeaufforderungen : Vordefinierte Vorlagen für gängige Entwicklungsaufgaben

Dokumentation

Ausführliche Dokumentation im Verzeichnis „docs“ verfügbar:

Projektstruktur

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

Schnelle Auswertung

Der Code Reasoning MCP Server verfügt über ein Bewertungssystem, das Claudes Fähigkeit bewertet, den Code Reasoning-Eingabeaufforderungen zu folgen. Dieses System ermöglicht:

  • Testen verschiedener Eingabeaufforderungsvarianten anhand von Szenarioproblemen

  • Überprüfen der Einhaltung des Parameterformats

  • Bewertung der Lösungsqualität

Um das System zur sofortigen Auswertung zu verwenden, führen Sie Folgendes aus:

npm run eval

Schneller Vergleich und Entwicklung

Es wurde erheblicher Aufwand betrieben, die optimale Eingabeaufforderung für den Code Reasoning-Server zu entwickeln. Die aktuelle Implementierung verwendet die Eingabeaufforderung HYBRID_DESIGN, die aus unserem Evaluierungsprozess als Sieger hervorging.

Wir haben vier verschiedene Prompt-Designs verglichen:

Schnelles Design

Beschreibung

SEQUENTIELL

Das ursprüngliche Design der sequenziellen Denkaufforderung

STANDARD

Die zuvor im Server verwendete Basiseingabeaufforderung

CODE_REASONING_0_30

Eine experimentelle Variante mit Fokus auf codespezifischem Denken

HYBRID_DESIGN

Ein verfeinertes Design, das die besten Elemente anderer Ansätze vereint

Unsere Auswertung anhand von sieben verschiedenen Programmierszenarien zeigte, dass HYBRID_DESIGN andere Eingabeaufforderungen übertraf:

Szenario

HYBRID_DESIGN

CODE_REASONING_0_30

STANDARD

SEQUENTIELL

Algorithmusauswahl

87 %

82 %

88 %

82 %

Fehleridentifizierung

87 %

91 %

88 %

92 %

Mehrstufige Implementierung

83 %

67 %

79 %

82 %

Systemdesignanalyse

82 %

87 %

78 %

82 %

Code-Debugging-Aufgabe

92 %

87 %

92 %

92 %

Compileroptimierung

83 %

78 %

67 %

73 %

Cache-Strategie

86 %

88 %

82 %

87 %

Durchschnitt

86 %

83 %

82 %

84 %

Der HYBRID_DESIGN-Prompt zeigte sowohl die höchste durchschnittliche Lösungsqualität (86 %) als auch die konstanteste Leistung über alle Szenarien hinweg, wobei keines der Ergebnisse unter 80 % lag. Er erzeugte auch die meisten Gedanken. Die Datei src/server.ts wurde aktualisiert, um dieses optimale Prompt-Design zu verwenden.

Persönlich denke ich, dass die größte Verbesserung darin bestand, Folgendes am Ende der Eingabeaufforderung hinzuzufügen: „✍️ Beenden Sie jeden Gedanken mit der Frage: „Was übersehe ich oder muss ich noch einmal überdenken?“

Weitere Einzelheiten zum System zur prompten Bewertung finden Sie im Test-Framework .

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei LICENSE.

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