Skip to main content
Glama
Code Reasoning MCP Server

Code Reasoning MCP Server

Сервер MCP для рассуждений о коде

Сервер Model Context Protocol (MCP), который расширяет возможности Клода по решению сложных задач программирования посредством структурированного пошагового мышления.

npm-версия Лицензия: Массачусетский технологический институт КИ

Быстрая установка

  1. Настройте Claude Desktop, отредактировав:

    • 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:

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

Related MCP server: Sequential Thinking MCP Server

Использование

  1. Чтобы активировать этот MCP, добавьте это к сообщениям чата:

    Use sequential thinking to reason about this.
  2. Используйте готовые подсказки, запускающие Code-Reasoning:

Подсказки по рассуждениям кода

  • Нажмите значок «+» в окне чата Claude Desktop или введите /help в Claude Code, чтобы увидеть конкретные команды.

  • Выберите «Добавить из Code Reasoning» из доступных инструментов.

  • Выберите шаблон запроса и заполните необходимую информацию

  • Заполните форму, чтобы добавить подсказку в сообщение чата, и нажмите «Ввод».

Подробную информацию об использовании шаблонов подсказок см. в Руководстве по подсказкам .

Параметры командной строки

  • --debug : Включить подробное ведение журнала

  • --help или -h : Показать справочную информацию

Основные характеристики

  • Фокус на программировании : оптимизирован для задач кодирования и решения проблем.

  • Структурированное мышление : разбейте сложные проблемы на управляемые шаги

  • Разветвление мыслей : параллельное изучение нескольких путей решения

  • Пересмотр мыслей : уточнение предыдущих рассуждений по мере улучшения понимания.

  • Пределы безопасности : Автоматически останавливается после 20 продуманных шагов, чтобы предотвратить зацикливание

  • Готовые к использованию подсказки : готовые шаблоны для общих задач разработки

Документация

Подробная документация доступна в каталоге docs:

Структура проекта

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

Быстрая оценка

Сервер Code Reasoning MCP включает в себя систему оценки подсказок, которая оценивает способность Клода следовать подсказкам code reasoning. Эта система позволяет:

  • Тестирование различных вариантов подсказок в зависимости от проблем сценария

  • Проверка соблюдения формата параметров

  • Оценка качества решения

Чтобы воспользоваться системой оперативной оценки, выполните:

npm run eval

Быстрое сравнение и разработка

Значительные усилия были направлены на разработку оптимального приглашения для сервера Code Reasoning. Текущая реализация использует приглашение HYBRID_DESIGN, которое оказалось победителем в нашем процессе оценки.

Мы сравнили четыре различных дизайна подсказок:

Быстрый дизайн

Описание

ПОСЛЕДОВАТЕЛЬНЫЙ

Оригинальный дизайн подсказки для последовательного мышления

ПО УМОЛЧАНИЮ

Базовый запрос, ранее использовавшийся на сервере

КОД_ПРИЧИНЫ_0_30

Экспериментальный вариант, ориентированный на рассуждения, специфичные для кода.

ГИБРИДНЫЙ_ДИЗАЙН

Изысканный дизайн, включающий в себя лучшие элементы других подходов

Наша оценка по семи различным сценариям программирования показала, что HYBRID_DESIGN превзошел другие подсказки:

Сценарий

ГИБРИДНЫЙ_ДИЗАЙН

КОД_ПРИЧИНЫ_0_30

ПО УМОЛЧАНИЮ

ПОСЛЕДОВАТЕЛЬНЫЙ

Выбор алгоритма

87%

82%

88%

82%

Идентификация ошибок

87%

91%

88%

92%

Многоэтапная реализация

83%

67%

79%

82%

Анализ проектирования системы

82%

87%

78%

82%

Задача отладки кода

92%

87%

92%

92%

Оптимизация компилятора

83%

78%

67%

73%

Стратегия кэширования

86%

88%

82%

87%

Средний

86%

83%

82%

84%

Подсказка HYBRID_DESIGN продемонстрировала как наивысшее среднее качество решения (86%), так и наиболее стабильную производительность во всех сценариях, без оценок ниже 80%. Она также вызвала больше всего мыслей. Файл src/server.ts был обновлен для использования этой оптимальной конструкции подсказки.

Лично я считаю, что самым большим улучшением стало добавление в конец подсказки следующего фразы: «✍️ Заканчивайте каждую мысль вопросом: «Что я упускаю или что мне нужно пересмотреть?»

Более подробную информацию о системе оперативной оценки см. в разделе «Структура тестирования» .

Лицензия

Этот проект лицензирован по лицензии MIT. Подробности см. в файле 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