MCP Advanced Reasoning Server for Cursor AI
AzDeltaQQ/Mcp-Reasoning-Server · 13 stars · TypeScript
MCP server This is a very basic implementation of an Mcp-Reasoning-Server for Cursor AI .
Install
The repo has no one-line install. Follow its README.
Files
Notable Mentions :
https://github.com/Jacck/mcp-reasoner
Thanks for giving me the idea Jacck .
MCP Advanced Reasoning Server for Cursor AI
A Model Context Protocol (MCP) server that provides advanced reasoning capabilities for Claude in Cursor AI.
Features
- Monte Carlo Tree Search (MCTS): Use MCTS reasoning for complex problem-solving tasks.
- Beam Search: Explore multiple reasoning paths simultaneously.
- R1 Transformer: Leverage Transformer-based reasoning for complex problems.
- Hybrid Reasoning: Combine Transformer analysis with MCTS for enhanced reasoning.
- Auto-Iterative Reasoning: All multi-step reasoning methods automatically complete all reasoning steps in a single tool call.
Installation
npm install npm run build
Usage
Configuring with Cursor AI
-
Build the server first:
cd mcp-reasoning-server npm run build
-
Open Cursor AI
-
Navigate to Settings > Features > MCP
-
Click the "+ Add new global MCP server" button
-
Enter the following details:
- In the command field:
node C:\\Users\\[YourUsername]\\path\\to\\mcp-reasoning-server\\dist\\index.js - Make sure to use the full path to your project's dist/index.js file
- Use double backslashes for Windows paths
- In the command field:
-
Click "Add"
-
Find your server in the list (it will initially show as "Disabled")
-
Click "Disabled" to toggle it to "Enabled"
-
Click the refresh button to load the available tools
-
A command prompt window will open automatically - this is your server running
-
As long as this command prompt window remains open, the reasoning tools will be available
Alternatively, you can manually edit your Cursor MCP configuration file at C:\Users\[Username]\.cursor\mcp.json (Windows):
{
"mcpServers": {
"mcp-reasoner": {
"command": "node",
"args": ["C:\\Users\\[Username]\\path\\to\\mcp-reasoning-server\\dist\\index.js"]
}
}
}
Important Notes
- Server Running: The tools are only available while the command prompt window is open and running
- Making Changes: If you make changes to the server code, you must rebuild it with
npm run buildbefore restarting - Restarting: To restart the server, close the command prompt window and toggle the server off/on in Cursor Settings
Using the Reasoning Tools
You can use the reasoning tools directly in your Cursor AI conversations with Claude:
MCTS Reasoning
Use the /reason-mcts command followed by your query to start a MCTS-based reasoning chain:
/reason-mcts How can I optimize the performance of this React component?
Beam Search Reasoning
Use the /reason-beam command for beam search-based reasoning:
/reason-beam What architecture would be best for this microservice system?
R1 Transformer Reasoning
Use the /reason-r1 command for single-step Transformer-based reasoning:
/reason-r1 Analyze the complexity of this algorithm.
Hybrid Reasoning
Use the /reason-hybrid command to combine Transformer and MCTS reasoning:
/reason-hybrid How should we approach refactoring this legacy codebase?
Claude Integration
To make it easier for Claude to work with these reasoning tools, you can add the following custom instructions:
When I use commands like /reason-mcts, /reason-beam, /reason-r1, or /reason-hybrid in chat, interpret them as requests to use the corresponding reasoning tools:
/reason-mcts: Use the reason_mcts tool with the text following the command as the query
Example: "/reason-mcts How do I solve this problem?" should call the reason_mcts tool
/reason-beam: Use the reason_beam tool with the text following the command as the query
Example: "/reason-beam What's the best approach for this complex problem?" should call the reason_beam tool
/reason-r1: Use the reason_r1 tool with the text following the command as the query
Example: "/reason-r1 Analyze this code for performance issues" should call the reason_r1 tool
/reason-hybrid: Use the reason_hybrid tool with the text following the command as the query
Example: "/reason-hybrid How should we restructure this architecture?" should call the reason_hybrid tool
When these commands are used, extract the text after the command as the query parameter and use the corresponding tool to perform advanced reasoning.
Development
Project Structure
src/index.ts: Main server entry pointsrc/tools/reasoning-tools.ts: Implementation of reasoning toolssrc/tools/reasoning-wrapper.ts: Command wrappers for easier use in Cursorsrc/utils/errors.ts: Error handling utilities
Auto-Iterative Reasoning
The reasoning tools are implemented to automatically complete all reasoning steps internally during a single tool call. Each reasoning method follows this process:
- Initialize the first thought/step
- Automatically generate subsequent thoughts/steps
- Return all thoughts along with the final result
This approach ensures that the reasoning process completes fully without requiring multiple manual tool calls.
Adding New Reasoning Methods
To add a new reasoning method, follow these steps:
- Add a new tool implementation in
src/tools/reasoning-tools.ts - Add a corresponding command wrapper in
src/tools/reasoning-wrapper.ts - Follow the pattern of existing tools, defining parameters and response format
- Implement auto-iteration if it's a multi-step reasoning method
- Rebuild the project with
npm run build
Limitations
This is a simulated reasoning server. In a production implementation, you would connect to actual reasoning algorithms instead of the placeholder responses currently used.
License
ISC
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 13
- Language
- TypeScript
- Last push
- 2025-03-19
- Forks
- 6
- 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
- 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
- 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
- 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
- 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
- 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k