How arben-adm/mcp-sequential-thinking works
MCP Sequential Thinking is a local MCP server for durable, resumable working notes—not a reasoning generator. A client invokes session tools to create a session, record linked evidence or decisions, read or finalize the notes, and optionally export or import an archive; the server delegates session operations to a SQLite repository. A deprecated legacy-tools branch remains, alongside analysis, migration, and whole-store backup. Relationships reflect the excerpts, SOURCE INDEX references, and README; unsampled implementation details are not inferred.
Main entry points: server.py MCP Server · sessions.py Session Repository · legacy.py Legacy Adapter · analysis.py Thought Analysis
Components 17
MCP Interface
- MCP Server
mcp_sequential_thinking/server.py - Session Tools
mcp_sequential_thinking/session_tools.py - Protocol Helpers
mcp_sequential_thinking/protocol.py - Response Limits
mcp_sequential_thinking/response_limits.py
Session Workflows
- Legacy Adapter
mcp_sequential_thinking/legacy.py - Session Repository
mcp_sequential_thinking/sessions.py - Thought Analysis
mcp_sequential_thinking/analysis.py - Thought Models
mcp_sequential_thinking/models.py - Result Schemas
mcp_sequential_thinking/schemas.py
Persistence
- Session Archives
mcp_sequential_thinking/session_archive.py - SQLite Store
mcp_sequential_thinking/sessions.py - Legacy Storage
mcp_sequential_thinking/storage.py - Storage Utilities
mcp_sequential_thinking/storage_utils.py - Store Backup
mcp_sequential_thinking/backup.py
Analysis and Operations
Other components
- MCP Client
Connections 22
- MCP Client → MCP Server: invokes tools
README.md - MCP Server → Session Tools: registers tools
mcp_sequential_thinking/server.py - MCP Server → Legacy Adapter: dispatches legacy
mcp_sequential_thinking/server.py - MCP Server → Thought Analysis: analyzes thoughts
mcp_sequential_thinking/server.py - MCP Server → Protocol Helpers: uses helpers
mcp_sequential_thinking/server.py - MCP Server → Response Limits: limits responses
mcp_sequential_thinking/server.py - MCP Server → Session Repository: creates repository
mcp_sequential_thinking/server.py - Session Tools → Session Repository: calls operations
mcp_sequential_thinking/session_tools.py - Legacy Adapter → Session Repository: adapts legacy data
mcp_sequential_thinking/legacy.py - Session Repository → SQLite Store: reads and writes
mcp_sequential_thinking/sessions.py - Thought Analysis → Thought Models: analyzes records
mcp_sequential_thinking/analysis.py - Thought Analysis → Result Schemas: builds results
mcp_sequential_thinking/analysis.py - Legacy Adapter → Thought Analysis: checks stages
mcp_sequential_thinking/legacy.py - Session Tools → Thought Models: validates inputs
mcp_sequential_thinking/session_tools.py - MCP Server → Session Archives: dispatches archives
mcp_sequential_thinking/server.py - Session Archives → Session Repository: imports and exports
mcp_sequential_thinking/session_archive.py - Session Archives → Legacy Storage: confines export paths
mcp_sequential_thinking/session_archive.py - Legacy Storage → Storage Utilities: uses file helpers
mcp_sequential_thinking/storage.py - Legacy Adapter → Legacy Storage: uses legacy storage
mcp_sequential_thinking/legacy.py - Store Backup → Session Repository: backs up store
mcp_sequential_thinking/backup.py - MCP Server → Logging: configures logging
mcp_sequential_thinking/server.py - MCP Server → Version: reports version
mcp_sequential_thinking/server.py