mcp-reasoner
A systematic reasoning MCP server implementation for Claude Desktop with beam search and thought evaluation. TypeScript-based implementation.
Documentation
MCP Reasoner
A reasoning implementation for Claude Desktop that lets you use both Beam Search and Monte Carlo Tree Search (MCTS). tbh this started as a way to see if we could make Claude even better at complex problem-solving... turns out we definitely can.
Current Version:
v2.0.0
What's New:
> Added 2 Experimental Reasoning Algorithms:
>
> - `mcts-002-alpha`
>
> - Uses the A* Search Method along with an early *alpha* implementation of a Policy Simulation Layer
>
> - Also includes an early *alpha* implementation of Adaptive Exploration Simulator & Outcome Based Reasoning Simulator
>
> *NOTE* the implementation of these alpha simulators is not complete and is subject to change
>
> - `mcts-002alt-alpha`
>
> - Uses the Bidirectional Search Method along with an early *alpha* implementation of a Policy Simulation Layer
>
> - Also includes an early *alpha* implementation of Adaptive Exploration Simulator & Outcome Based Reasoning Simulator
>
> *NOTE* the implementation of these alpha simulators is not complete and is subject to change
What happened to `mcts-001-alpha` and `mcts-001alt-alpha`?
> Quite simply: It was useless and near similar to the base `mcts` method. After initial testing the results yielded in basic thought processes was near similar showing that simply adding policy simulation may not have an effect.
So why add Polciy Simulation Layer now?
> Well i think its important to incorporate Policy AND Search in tandem as that is how most of the algorithms implement them.
Previous Versions:
v1.1.0
> Added model control over search parameters:
>
> beamWidth - lets Claude adjust how many paths to track (1-10)
>
> numSimulations - fine-tune MCTS simulation count (1-150)
Features
- Two search strategies that you can switch between:
- Tracks how good different reasoning paths are
- Maps out all the different ways Claude thinks through problems
- Analyzes how the reasoning process went
- Follows the MCP protocol (obviously)
Installation
git clone https://github.com/frgmt0/mcp-reasoner.git
OR clone the original:
git clone https://github.com/Jacck/mcp-reasoner.git
cd mcp-reasoner
npm install
npm run buildConfiguration
Add to Claude Desktop config:
{
"mcpServers": {
"mcp-reasoner": {
"command": "node",
"args": ["path/to/mcp-reasoner/dist/index.js"],
}
}
}Testing
[More Testing Coming Soon]
Benchmarks
[Benchmarking will be added soon]
Key Benchmarks to test against:
- MATH500
- GPQA-Diamond
- GMSK8
- Maybe Polyglot &/or SWE-Bench
License
This project is licensed under the MIT License - see the LICENSE file for details.
Frequently asked questions
What is mcp-reasoner?
mcp-reasoner is A systematic reasoning MCP server implementation for Claude Desktop with beam search and thought evaluation. TypeScript-based implementation.
How do I install mcp-reasoner?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is mcp-reasoner open source?
Yes — it is hosted on GitHub at https://github.com/Jacck/mcp-reasoner and has 258 stars.
Related MCP tools
MCP server that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account. TypeScript-based implementation.
A collection of Model Context Protocol servers for popular security tools like SQLMap, FFUF, NMAP, Masscan and more. TypeScript-based implementation.
A Model Context Protocol server that executes commands in the current iTerm session - useful for REPL and CLI assistance
Enable any LLM (e.g. Claude) to interactively debug any language for you via MCP and a VS Code Extension TypeScript-based implementation.
A powerful VSCode extension that lets you find and install MCP servers to use with GitHub Copilot.. TypeScript-based implementation.
Add Obsidian integrations like semantic search and custom Templater prompts to Claude or any MCP client. TypeScript-based implementation.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP