Smart Thinking MCP server

Smart-Thinking is a sophisticated MCP (Model Context Protocol) server providing a multi-dimensional, adaptive, and self-verifying reasoning framework for AI assistants like Claude. Unlike traditional linear reasoning approaches, it implements a graph-based architecture that enables complex connections between thoughts, offering more nuanced reasoning capabilities closer to human cognition.

Installation Options

Global Installation (Recommended)

# On macOS/Linux
npm install -g smart-thinking-mcp

# On Windows (using PowerShell or CMD)
npm install -g smart-thinking-mcp

Via Smithery

To automatically install Smart-Thinking using Smithery:

npx -y @smithery/cli install @Leghis/smart-thinking --client claude

Using npx (Without Installation)

# On macOS/Linux
npx -y smart-thinking-mcp

# On Windows (less recommended, prefer global installation)
npx -y smart-thinking-mcp

From Source Code

# Clone the repository
git clone https://github.com/Leghis/Smart-Thinking.git
cd Smart-Thinking

# Install dependencies
npm install

# Build the project
npm run build

# Create a global npm link
npm link

Configuration with Claude Desktop

macOS Configuration

Add this configuration to your ~/Library/Application Support/Claude/claude_desktop_config.json file:

{
  "mcpServers": {
    "smart-thinking": {
      "command": "smart-thinking-mcp"
    }
  }
}

OR using npx:

{
  "mcpServers": {
    "smart-thinking": {
      "command": "npx",
      "args": ["-y", "smart-thinking-mcp"]
    }
  }
}

Windows Configuration

Add this configuration to your %APPDATA%\Claude\claude_desktop_config.json file:

{
  "mcpServers": {
    "smart-thinking": {
      "command": "C:/Users/YourName/AppData/Roaming/npm/smart-thinking-mcp.cmd"
    }
  }
}

OR with the full path to Node.js (recommended for Windows):

{
  "mcpServers": {
    "smart-thinking": {
      "command": "C:/Program Files/nodejs/node.exe",
      "args": ["C:/Users/YourName/AppData/Roaming/npm/node_modules/smart-thinking-mcp/build/index.js"]
    }
  }
}

Important:

• Replace YourName with your Windows username.
• Use forward slashes (/) in Windows paths, even though the OS uses backslashes (\).

Data Directory Configuration

By default, Smart-Thinking creates and uses a data folder in its working directory. You can specify a custom directory using the SMART_THINKING_DATA_DIR environment variable:

{
  "mcpServers": {
    "smart-thinking": {
      "command": "smart-thinking-mcp",
      "env": {
        "SMART_THINKING_DATA_DIR": "/absolute/path/to/data"
      }
    }
  }
}

Usage

Main Parameters

Parameter	Type	Description
thought	string	Content of the thought to analyze (required)
thoughtType	string	Type of thought ('regular', 'revision', 'meta', 'hypothesis', 'conclusion')
connections	array	Connections to other thoughts
requestVerification	boolean	Enable automatic verification
containsCalculations	boolean	Indicate if the thought contains calculations
generateVisualization	boolean	Generate a visualization of the thought graph
suggestTools	boolean	Suggest relevant MCP tools
sessionId	string	Session identifier for persistence

Usage Examples

Simple Reasoning

Use the Smart-Thinking tool to analyze the advantages and disadvantages of renewable energy.

With Automatic Verification

Use Smart-Thinking with verification (requestVerification=true) to evaluate the following claims about climate change.

With Visualization

Use Smart-Thinking with visualization (generateVisualization=true) to develop a multi-layered marketing strategy.

Collaborative Analysis

Use Smart-Thinking with a session identifier (sessionId="innovation-project") to analyze this complex optimization problem.

Verification System

Smart-Thinking incorporates a sophisticated verification system that evaluates the reliability of information and calculations with 8 distinct verification statuses:

Status	Description
verified	Information verified with confidence
partially_verified	Information partially verified
unverified	Information not verified
contradicted	Information contradicted by other sources
inconclusive	Verification inconclusive
absence_of_information	Absence of information on the subject
uncertain	Information uncertain due to contradictions
contradictory	Information inherently contradictory

Troubleshooting

Quick Functionality Check

To verify that Smart-Thinking is working correctly:

# On macOS/Linux
smart-thinking-mcp

# On Windows
smart-thinking-mcp.cmd

You should see the server startup message.

Check the Logs

If you encounter difficulties, check the Claude Desktop logs:

• On macOS: ~/Library/Logs/Claude/mcp*.log
• On Windows: %USERPROFILE%\AppData\Local\Claude\logs\mcp*.log
• On Linux: ~/.local/share/Claude/logs/mcp*.log

Common Issues and Solutions

Problem	Solution
Smart-Thinking doesn't appear in Claude	Check paths in configuration, restart Claude Desktop
File access errors	Check permissions of the data directory
Connection issues on Windows	Use complete and absolute paths with forward slashes
Errors with NVM on Windows	Use the full path to the active Node.js version

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "smart-thinking" '{"command":"smart-thinking-mcp"}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "smart-thinking": {
            "command": "smart-thinking-mcp"
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "smart-thinking": {
            "command": "smart-thinking-mcp"
        }
    }
}

3. Restart Claude Desktop for the changes to take effect