mcpField
C
Code Reasoning MCP Server

Code Reasoning MCP Server

Local
github.com/mettamattAI & Agents255Updated 38w ago
Repository

About Code Reasoning MCP Server

Code Reasoning MCP Server is a fork of sequential-thinking that gives Claude structured, step-by-step reasoning for complex programming tasks. It suits developers who want problems broken into explicit thought steps.

Key features

  1. 01Optimized for coding tasks
  2. 02Structured step-by-step thinking
  3. 03Thought branching for parallel solution paths
  4. 04Thought revision to refine earlier reasoning
  5. 05Safety limit of 20 thought steps
  6. 06Ready-to-use prompt templates

Use cases

  1. 01Breaking down complex programming problems
  2. 02Comparing multiple solution paths
  3. 03Running reasoning flows from Claude Desktop or VS Code

MCP support

This is an MCP server launched via npx from Claude Desktop or VS Code configuration. It exposes reasoning tools and prompt templates to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "code-reasoning": {
      "command": "npx",
      "args": [
        "-y",
        "@mettamatt/code-reasoning"
      ]
    }
  }
}
Run commandnpx -y @mettamatt/code-reasoning

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@mettamatt/code-reasoning

Tools

1

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
thoughtstringYes
thought_numberintegerYes
total_thoughtsintegerYes
next_thought_neededbooleanYes
is_revisionbooleanNo
revises_thoughtintegerNo
branch_from_thoughtintegerNo
branch_idstringNo
needs_more_thoughtsbooleanNo

Details

From the project README

Code Reasoning MCP Server

A Model Context Protocol (MCP) server that enhances Claude's ability to solve complex programming tasks through structured, step-by-step thinking.

Code Reasoning Server MCP server

npm version License: MIT CI

Quick Installation

  1. Configure Claude Desktop by editing:

    • 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. Configure VS Code:

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

Usage

  1. To trigger this MCP, append this to your chat messages:

    Use sequential thinking to reason about this.

  2. Use ready-to-go prompts that trigger Code-Reasoning:

Code Reasoning Prompts

  • Click the "+" icon in the Claude Desktop chat window, or in Claude Code type /help to see the specific commands.
  • Select "Add from Code Reasoning" from the available tools
  • Choose a prompt template and fill in the required information
  • Submit the form to add the prompt to your chat message and hit return

See the Prompts Guide for details on using the prompt templates.

Command Line Options

  • --debug: Enable detailed logging
  • --help or -h: Show help information

Key Features

  • Programming Focus: Optimized for coding tasks and problem-solving
  • Structured Thinking: Break down complex problems into manageable steps
  • Thought Branching: Explore multiple solution paths in parallel
  • Thought Revision: Refine earlier reasoning as understanding improves
  • Safety Limits: Automatically stops after 20 thought steps to prevent loops
  • Ready-to-Use Prompts: Pre-defined templates for common development tasks

Documentation

Detailed documentation available in the docs directory:

Project Structure

├── index.ts                  # Entry point
├── src/                      # Implementation source files
└── test/                     # Placeholder for future test utilities

License

This project is licensed under the MIT License. See the LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.