Enhances AI-assisted development through sequential thinking capabilities, allowing GitHub Copilot to break down complex problems, analyze PDFs, and work with transportation planning models with contextual awareness
Visum Thinker MCP Server
A Model Context Protocol (MCP) server that provides structured sequential thinking capabilities for problem-solving and analysis. This server enables AI assistants to break down complex problems into manageable steps, revise thoughts, and explore alternative reasoning paths.
Features
Step-by-step reasoning: Break down complex problems into sequential thoughts
Dynamic revision: Revise and refine thoughts as understanding deepens
Branching logic: Branch into alternative reasoning paths
Adaptive planning: Adjust the total number of thoughts dynamically
State management: Maintain thinking context across multiple tool calls
Progress tracking: Monitor completion status and thought progression
PDF Analysis: Load and analyze PDF documents for problem-solving context
Content Search: Find relevant sections in PDFs based on queries and search terms
Persistent Storage: Auto-save state to disk, survive server restarts
Knowledge Transfer: Export/import thinking sessions between servers
🚗 Visum Integration: Complete PTV Visum COM API integration for transportation planning
Smart Path Learning: Automatically discovers and remembers custom Visum installation paths
Zero Configuration: Once set up, works seamlessly across server restarts
Demo Mode: Full functionality testing without requiring Visum installation
Transportation Analysis: Load models, run calculations, analyze networks and matrices
Installation
Quick Installation
See INSTALLATION.md for detailed setup instructions.
Prerequisites
Node.js 16 or higher
npm or yarn
Usage
With Claude Desktop
Add to your Claude Desktop configuration (claude_desktop_config.json
):
With VS Code
The project includes a .vscode/mcp.json
configuration file for VS Code MCP integration.
Direct Usage
Tools
sequential_thinking
Main tool for step-by-step reasoning process.
Parameters:
thought
(string): The current thinking stepnextThoughtNeeded
(boolean): Whether another thought step is neededthoughtNumber
(integer): Current thought numbertotalThoughts
(integer): Estimated total thoughts neededisRevision
(boolean, optional): Whether this revises previous thinkingrevisesThought
(integer, optional): Which thought is being reconsideredbranchFromThought
(integer, optional): Branching point thought numberbranchId
(string, optional): Branch identifierneedsMoreThoughts
(boolean, optional): If more thoughts are needed
load_pdf
Load a PDF file to provide context for analysis.
Parameters:
filePath
(string): Absolute path to the PDF file
analyze_pdf_section
Analyze specific sections of the loaded PDF.
Parameters:
query
(string): What to look for or analyze in the PDFstartPage
(integer, optional): Starting page number (1-based)endPage
(integer, optional): Ending page number (1-based)searchTerms
(array of strings, optional): Specific terms to search for
reset_thinking
Clears the current thinking state to start fresh.
get_thinking_summary
Returns a summary of the current thinking session including PDF context if loaded.
export_knowledge
Export the current thinking state and PDF knowledge to a file.
Parameters:
exportPath
(string): Absolute path where to save the exported knowledge file
import_knowledge
Import thinking state and PDF knowledge from an exported file.
Parameters:
importPath
(string): Absolute path to the exported knowledge file to import
🚗 Visum Transportation Planning Tools
The server includes comprehensive PTV Visum integration with intelligent path learning:
check_visum
: Check Visum availability and learn custom installation pathsload_visum_model
: Load transportation models (.ver files)run_visum_calculation
: Execute transportation calculations and analysesget_network_statistics
: Analyze network topology and characteristicsanalyze_visum_matrices
: Examine demand and flow matricesexport_visum_results
: Export analysis results to various formats
Key Features:
🧠 Smart Path Learning: Automatically remembers custom Visum installation paths
🔄 Zero Setup: Works seamlessly after initial path discovery
🎯 Demo Mode: Full testing capability without Visum installation
📊 Complete Analysis: All major transportation planning workflows supported
See VISUM-PATH-LEARNING.md for detailed information about the intelligent path learning system.
🤖 GitHub Copilot Integration
The Sequential Thinking MCP Server includes comprehensive GitHub Copilot integration for enhanced AI-assisted development:
🚀 Quick Start with Copilot
Server Status: Ensure MCP server is running (
npm run dev
)Open Copilot Chat:
Ctrl+Shift+I
in VS CodeTest Integration: Ask
@copilot List available MCP tools
Start Solving:
@copilot Use sequential thinking to solve [your problem]
🎯 Copilot Capabilities
🧠 Sequential Thinking: AI-guided step-by-step problem solving
📄 PDF Analysis: Intelligent document processing and analysis
🚗 Transportation Planning: Expert Visum integration and workflow automation
🔧 Smart Configuration: Automatic Visum path learning and persistence
💡 Context-Aware Suggestions: Code completion with domain knowledge
💬 Example Copilot Interactions
See COPILOT-INTEGRATION.md for comprehensive setup and usage guide.
Development
Project Structure
Scripts
npm run build
: Compile TypeScript to JavaScriptnpm run dev
: Build and run the servernpm test
: Run tests (placeholder)
Debugging
The server logs to stderr for compatibility with STDIO transport. Use VS Code's debugging features or add console.error statements for debugging.
Architecture
The server maintains a global thinking state that tracks:
All thoughts in the current session
Current progress and estimated completion
Revision and branching relationships
Session completion status
Each tool call updates this state and provides formatted responses that help users follow the thinking process.
License
MIT
Tools
Provides structured sequential thinking capabilities for AI assistants to break down complex problems into manageable steps, revise thoughts, and explore alternative reasoning paths.
Related MCP Servers
- AsecurityAlicenseAqualityEnhances AI model capabilities with structured, retrieval-augmented thinking processes that enable dynamic thought chains, parallel exploration paths, and recursive refinement cycles for improved reasoning.Last updated -16MIT License
- -securityFlicense-qualityProvides tools for structuring complex problems through narrative-based sequential story elements or systematic sequential thinking, helping make complex problems more memorable and easier to understand.Last updated -14
- AsecurityAlicenseAqualityAn enhanced sequential thinking tool optimized for programming tasks that helps break down complex coding problems into structured, self-auditing thought steps with branching and revision capabilities.Last updated -1209220MIT License
- AsecurityAlicenseAqualityProvides AI assistants with enhanced reasoning capabilities through structured thinking, persistent knowledge graph memory, and intelligent tool orchestration for complex problem-solving.Last updated -205151MIT License