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.

Quick Installation

1. Configure Claude Desktop by editing:
2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Windows: %APPDATA%\Claude\claude_desktop_config.json
4. Linux: ~/.config/Claude/claude_desktop_config.json

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

1. 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.

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

2. Click the "+" icon in the Claude Desktop chat window, or in Claude Code type /help to see the specific commands.

3. Select "Add from Code Reasoning" from the available tools
4. Choose a prompt template and fill in the required information
5. 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:

• Usage Examples: Examples of sequential thinking with the MCP server
• Configuration Guide: All configuration options for the MCP server
• Prompts Guide: Using and customizing prompts with the MCP server
• Testing Framework: Testing information

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.