Sequential Thinking MCP

Sequential Thinking MCP Server

A Model Context Protocol (MCP) server that facilitates structured, progressive thinking through defined stages. This tool helps break down complex problems into sequential thoughts, track the progression of your thinking process, and generate summaries.

Features

Structured Thinking Framework: Organizes thoughts through standard cognitive stages (Problem Definition, Research, Analysis, Synthesis, Conclusion)

Thought Tracking: Records and manages sequential thoughts with metadata

Related Thought Analysis: Identifies connections between similar thoughts

Progress Monitoring: Tracks your position in the overall thinking sequence

Summary Generation: Creates concise overviews of the entire thought process

Persistent Storage: Automatically saves your thinking sessions

Data Import/Export: Share and reuse thinking sessions

Extensible Architecture: Easily customize and extend functionality

Prerequisites

Python 3.10 or higher

UV package manager (Install Guide)

Project Structure

Quick Start

Set Up Project

Run the Server

Run Tests

Claude Desktop Integration

Add to your Claude Desktop configuration (%APPDATA%\Claude\claude_desktop_config.json on Windows):

Alternatively, if you've installed the package with pip install -e ., you can use:

How It Works

The server maintains a history of thoughts and processes them through a structured workflow. Each thought is validated, categorized, and stored with relevant metadata for later analysis.

Usage Guide

The Sequential Thinking server exposes three main tools:

1. `process_thought`

Records and analyzes a new thought in your sequential thinking process.

Parameters:

thought (string): The content of your thought

thought_number (integer): Position in your sequence (e.g., 1 for first thought)

total_thoughts (integer): Expected total thoughts in the sequence

next_thought_needed (boolean): Whether more thoughts are needed after this one

stage (string): The thinking stage - must be one of:

tags (list of strings, optional): Keywords or categories for your thought

axioms_used (list of strings, optional): Principles or axioms applied in your thought

assumptions_challenged (list of strings, optional): Assumptions your thought questions or challenges

Example:

2. `generate_summary`

Generates a summary of your entire thinking process.

Example output:

3. `clear_history`

Resets the thinking process by clearing all recorded thoughts.

Practical Applications

Decision Making: Work through important decisions methodically

Problem Solving: Break complex problems into manageable components

Research Planning: Structure your research approach with clear stages

Writing Organization: Develop ideas progressively before writing

Project Analysis: Evaluate projects through defined analytical stages

Getting Started

With the proper MCP setup, simply use the process_thought tool to begin working through your thoughts in sequence. As you progress, you can get an overview with generate_summary and reset when needed with clear_history.

Customizing the Sequential Thinking Server

For detailed examples of how to customize and extend the Sequential Thinking server, see example.md. It includes code samples for:

Modifying thinking stages

Enhancing thought data structures

Adding persistence

Implementing enhanced analysis

Creating custom prompts

Setting up advanced configurations

License

MIT License