Code Reasoning MCP Server
Сервер MCP для рассуждений о коде
Сервер Model Context Protocol (MCP), который расширяет возможности Клода по решению сложных задач программирования посредством структурированного пошагового мышления.
Быстрая установка
Настройте Claude Desktop, отредактировав:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
{ "mcpServers": { "code-reasoning": { "command": "npx", "args": ["-y", "@mettamatt/code-reasoning"] } } }Настройте VS Code:
{
"mcp": {
"servers": {
"code-reasoning": {
"command": "npx",
"args": ["-y", "@mettamatt/code-reasoning"]
}
}
}
}Related MCP server: Sequential Thinking MCP Server
Использование
Чтобы активировать этот MCP, добавьте это к сообщениям чата:
Use sequential thinking to reason about this.Используйте готовые подсказки, запускающие Code-Reasoning:

Нажмите значок «+» в окне чата Claude Desktop или введите
/helpв Claude Code, чтобы увидеть конкретные команды.Выберите «Добавить из Code Reasoning» из доступных инструментов.
Выберите шаблон запроса и заполните необходимую информацию
Заполните форму, чтобы добавить подсказку в сообщение чата, и нажмите «Ввод».
Подробную информацию об использовании шаблонов подсказок см. в Руководстве по подсказкам .
Параметры командной строки
--debug: Включить подробное ведение журнала--helpили-h: Показать справочную информацию
Основные характеристики
Фокус на программировании : оптимизирован для задач кодирования и решения проблем.
Структурированное мышление : разбейте сложные проблемы на управляемые шаги
Разветвление мыслей : параллельное изучение нескольких путей решения
Пересмотр мыслей : уточнение предыдущих рассуждений по мере улучшения понимания.
Пределы безопасности : Автоматически останавливается после 20 продуманных шагов, чтобы предотвратить зацикливание
Готовые к использованию подсказки : готовые шаблоны для общих задач разработки
Документация
Подробная документация доступна в каталоге docs:
Примеры использования : Примеры последовательного мышления с сервером MCP
Руководство по настройке : все параметры конфигурации сервера MCP
Руководство по подсказкам : использование и настройка подсказок с помощью сервера MCP
Тестирование Framework : информация о тестировании
Структура проекта
├── 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 toolcode-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
Scored across 1 tool
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.
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.
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.
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
Related MCP Connectors
Adaptive plan/build/review cycles for AI coding assistants, persisted across sessions.
Source-checked CLI guides and model-aware planning for Claude Code, Codex, and Grok Build.
AI-native programming language and toolchain for accountable, verifiable agent-driven development.
Knowledge accumulation for AI coding agents. Records decisions, problems, and insights as context.
Related MCP Servers
- AlicenseBqualityNot gradedmaintenanceProvides structured sequential thinking capabilities for AI assistants to break down complex problems into manageable steps, revise thoughts, and explore alternative reasoning paths.29-
- AlicenseAqualityDmaintenanceEnables structured, step-by-step problem-solving with dynamic revision and branching capabilities. Supports breaking down complex problems into manageable steps while allowing course corrections and alternative reasoning paths.11MIT
- AlicenseAqualityCmaintenanceEnables structured step-by-step reasoning with branching, revisions, and self-critique to help break down complex problems into manageable steps with confidence tracking and thought history search.753 npm7MIT
- AlicenseAqualityDmaintenanceEnables structured, step-by-step problem-solving through dynamic thinking processes that can be revised, branched, and adjusted as understanding deepens. Supports breaking down complex problems into manageable steps with the ability to revise previous thoughts and explore alternative reasoning paths.1MIT
Appeared in Searches
- A server for learning and finding resources about SAS programming
- Tools and frameworks for thinking about software development
- A server for finding information about sequential thinking
- A tool for critical thinking and devil's advocate analysis of AI model plans
- Tools for slow thinking, step-back reasoning, and contextual memory capabilities