Structured Thinking MCP Server

A TypeScript implementation of the Structured Thinking Python server by Arben Ademi using the Model Context Protocol (MCP).

The motivation for the translation was to allow easier global installation and usage of the tool. (The Python ecosystem discourages global installation.)

Setup

Set the tool configuration in Claude Desktop, Cursor, or another MCP client as follows:

{
  "structured-thinking": {
    "command": "npx",
    "args": ["-y", "structured-thinking"]
  }
}

Overview

This server provides tools for structured, reflective thinking through a series of thought stages. It implements:

• Sequential thinking with stage management
• Memory consolidation for thought patterns
• Reasoning strategy application
• Metacognitive monitoring and analysis

Features

• Thought Stages: Process thinking through structured stages (Problem Definition, Analysis, Ideation, etc.)
• Memory Management: Store important thoughts for later reference
• Reasoning Patterns: Apply different reasoning strategies (deductive, inductive, creative, etc.)
• Metacognitive Insights: Analyze thought quality and provide improvement suggestions
• Branching Support: Create and manage thought branches for exploring alternatives

MCP Tools

The server exposes the following MCP tools:

think

Process a structured thought with reflective analysis.

Parameters:

• thought: The content of the current thought
• thought_number: Current position in the sequence
• total_thoughts: Expected total number of thoughts
• next_thought_needed: Whether another thought should follow
• stage: Current thinking stage (e.g., "Problem Definition", "Analysis")
• is_revision (optional): Whether this revises a previous thought
• revises_thought (optional): Number of thought being revised
• branch_from_thought (optional): Starting point for a new thought branch
• branch_id (optional): Identifier for the current branch
• needs_more_thoughts (optional): Whether additional thoughts are needed
• score (optional): Quality score (0.0 to 1.0)
• tags (optional): Categories or labels for the thought

get_thinking_summary

Generate a comprehensive summary of the entire thinking process.

clear_thinking_history

Clear all recorded thoughts and reset the server state.

License

MIT