Skip to main content
Glama

Visum Thinker MCP Server

by multiluca2020
OverviewInspectSchemaRelated ServersScoreDiscussions
Local
MIT License

Visum Thinker MCP Server

A Model Context Protocol (MCP) server that provides PTV Visum automation and sequential thinking capabilities for transportation planning and analysis.

šŸŽÆ Quick Start

New to Visum automation? ā†’ Start here: QUICKSTART_PRT_WORKFLOW.md

AI Assistant integration? ā†’ Read: CLAUDE_WORKFLOW_GUIDE.md

Full Documentation? ā†’ See: DOCUMENTATION_INDEX.md

Related MCP server: Sequential Story MCP Server

āœØ New Features (2025-10-10)

šŸš— Interactive Visum Procedure Creation with Auto-Organization

Create and configure PTV Visum procedures with automatic organization in "Visum-BOT" group:

// 1. Create procedure ā†’ Automatic group creation + delete operation visum_create_procedure({procedureType: "PrT_Assignment"}) // ā†’ Returns: // - group_position: 577 (Visum-BOT group) // - delete_position: 580 (Initialize Assignment) // - actual_position: 581 (PrT Assignment) ā­ Use this! // 2. List available demand segments (numbered 1-36) visum_list_demand_segments() // 3. Configure with user's choice visum_configure_dsegset({ procedurePosition: 581, // Use actual_position! segmentNumbers: "1-10" // or filterMode: "C", etc. })

āœØ Automatic Features:

  • šŸ“¦ Group Organization: All MCP operations in "Visum-BOT" group

  • šŸ—‘ļø Auto-Delete: Initialize Assignment added before PrT/PuT assignments

  • šŸ”„ Group Reuse: Subsequent calls add to existing group

  • šŸ“ Smart Positioning: Operations added at end of group

šŸ“– Documentation: See VISUM_BOT_GROUP.md for complete details

**Key Features:** - āœ… **Automatic position detection** - No manual position tracking - āœ… **Numbered segment selection** - Easy "1-10" notation instead of long codes - āœ… **4 flexible input formats** - Numbers, mode filter, ALL keyword, or explicit codes - āœ… **Interactive workflow** - AI assistants guide users through configuration - āœ… **Complete validation** - Automatic verification of all configurations **See [QUICKSTART_PRT_WORKFLOW.md](QUICKSTART_PRT_WORKFLOW.md) for the 3-step workflow!** ## Features ### šŸš— Visum Transportation Planning - **Procedure Management**: Create PrT/PuT Assignment, Demand Models, Matrix Calculations - **Demand Segments**: List and configure demand segments with numbered selection - **Interactive Configuration**: Guide users through DSEGSET setup with 4 input formats - **Smart Position Tracking**: Automatically track actual procedure positions - **Complete Validation**: Verify all configurations before execution ### šŸ§  Sequential Thinking - **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 - **PDF Loading**: 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 ## Installation ### Quick Installation ```bash # Option 1: Install from NPM npm install -g visum-thinker-mcp-server # Option 2: Use with npx (no installation) npx visum-thinker-mcp-server # Option 3: Clone from GitHub git clone https://github.com/yourusername/visum-thinker-mcp-server.git cd visum-thinker-mcp-server npm install && npm run build

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):

{ "mcpServers": { "visum-thinker": { "command": "node", "args": ["/absolute/path/to/sequential_thinking/build/index.js"] } } }

With VS Code

The project includes a .vscode/mcp.json configuration file for VS Code MCP integration.

Direct Usage

npm run dev

Tools

sequential_thinking

Main tool for step-by-step reasoning process.

Parameters:

  • thought (string): The current thinking step

  • nextThoughtNeeded (boolean): Whether another thought step is needed

  • thoughtNumber (integer): Current thought number

  • totalThoughts (integer): Estimated total thoughts needed

  • isRevision (boolean, optional): Whether this revises previous thinking

  • revisesThought (integer, optional): Which thought is being reconsidered

  • branchFromThought (integer, optional): Branching point thought number

  • branchId (string, optional): Branch identifier

  • needsMoreThoughts (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 PDF

  • startPage (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 paths

  • load_visum_model: Load transportation models (.ver files)

  • run_visum_calculation: Execute transportation calculations and analyses

  • get_network_statistics: Analyze network topology and characteristics

  • analyze_visum_matrices: Examine demand and flow matrices

  • export_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

  1. Server Status: Ensure MCP server is running (npm run dev)

  2. Open Copilot Chat: Ctrl+Shift+I in VS Code

  3. Test Integration: Ask @copilot List available MCP tools

  4. 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

@copilot Can you use sequential thinking to analyze this transportation network problem? @copilot Check if Visum is available and help me load a network model @copilot Use the PDF analysis tools to extract data from this traffic report @copilot Create a complete workflow for transportation demand analysis

See COPILOT-INTEGRATION.md for comprehensive setup and usage guide.

Development

Project Structure

sequential_thinking/ ā”œā”€ā”€ src/ ā”‚ ā””ā”€ā”€ index.ts # Main server implementation ā”œā”€ā”€ build/ # Compiled JavaScript output ā”œā”€ā”€ .vscode/ ā”‚ ā””ā”€ā”€ mcp.json # VS Code MCP configuration ā”œā”€ā”€ .github/ ā”‚ ā””ā”€ā”€ copilot-instructions.md ā”œā”€ā”€ package.json ā”œā”€ā”€ tsconfig.json ā””ā”€ā”€ README.md

Scripts

  • npm run build: Compile TypeScript to JavaScript

  • npm run dev: Build and run the server

  • npm 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

One-click Deploy
A
security ā€“ no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/multiluca2020/visum-thinker-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server