**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
Usage
Configuring with Cursor AI
Build the server first:
```bash
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
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):
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 build` before 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:
Beam Search Reasoning
Use the `/reason-beam` command for beam search-based reasoning:
R1 Transformer Reasoning
Use the `/reason-r1` command for single-step Transformer-based reasoning:
Hybrid Reasoning
Use the `/reason-hybrid` command to combine Transformer and MCTS reasoning:
Claude Integration
To make it easier for Claude to work with these reasoning tools, you can add the following custom instructions:
Development
Project Structure
`src/index.ts`: Main server entry point
`src/tools/reasoning-tools.ts`: Implementation of reasoning tools
`src/tools/reasoning-wrapper.ts`: Command wrappers for easier use in Cursor
`src/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.