How xrds76354/sumo-mcp-server works
SUMO-MCP exposes SUMO traffic-simulation capabilities as MCP tools. The primary user workflow is the documented sim-gen/eval pipeline: create a network, generate demand, compute routes, run simulation, and analyze FCD output. Separate branches provide network-format conversion, signal optimization, online TraCI control/state queries, and reinforcement-learning training. The graph reflects README-documented workflows and source-index references; several modules were not sampled, so their internal calls are not inferred.
Main entry points: server.py MCP Tool Server · network.py Network Tools · simulation.py Simulation Runner · sim_gen.py Sim Gen Workflow
Components 20
MCP Interface
- MCP Tool Server
src/server.py
Offline Simulation
- Network Tools
src/mcp_tools/network.py - ezdesignX Conversion
src/mcp_tools/ezdesignx.py - Demand Tools
src/mcp_tools/route.py - Signal Optimization Tools
src/mcp_tools/signal.py - Simulation Runner
src/mcp_tools/simulation.py - FCD Analysis
src/mcp_tools/analysis.py - Sim Gen Workflow
src/workflows/sim_gen.py - Signal Workflow
src/workflows/signal_opt.py - RL Training Workflow
src/workflows/rl_train.py - RL Training Engine
src/mcp_tools/rl.py
Online Control
- Vehicle Queries
src/mcp_tools/vehicle.py - TraCI Connection
src/utils/connection.py - TraCI Helpers
src/utils/traci.py
Runtime Support
- SUMO Discovery
src/utils/sumo.py - Timeout Handling
src/utils/timeout.py - Output Formatting
src/utils/output.py
Other components
- AI Agent
- Eclipse SUMO
- OpenStreetMap
Connections 36
- AI Agent → MCP Tool Server: invokes tools
README.md - MCP Tool Server → Network Tools: dispatches network tools
src/server.py - MCP Tool Server → ezdesignX Conversion: dispatches conversion
src/server.py - MCP Tool Server → Demand Tools: dispatches demand tools
src/server.py - MCP Tool Server → Signal Optimization Tools: dispatches signal tools
src/server.py - MCP Tool Server → Simulation Runner: dispatches simulation
src/server.py - MCP Tool Server → FCD Analysis: dispatches analysis
src/server.py - MCP Tool Server → Vehicle Queries: dispatches queries
src/server.py - MCP Tool Server → RL Training Engine: dispatches RL tasks
src/server.py - MCP Tool Server → Sim Gen Workflow: starts workflow
src/server.py - MCP Tool Server → Signal Workflow: starts workflow
src/server.py - MCP Tool Server → RL Training Workflow: starts workflow
src/server.py - Sim Gen Workflow → Network Tools: generates network
src/workflows/sim_gen.py - Sim Gen Workflow → Demand Tools: generates demand and routes
src/workflows/sim_gen.py - Sim Gen Workflow → Simulation Runner: runs simulation
src/workflows/sim_gen.py - Sim Gen Workflow → FCD Analysis: analyzes results
src/workflows/sim_gen.py - Signal Workflow → Simulation Runner: runs baseline and optimized
src/workflows/signal_opt.py - Signal Workflow → Signal Optimization Tools: optimizes signals
src/workflows/signal_opt.py - Signal Workflow → FCD Analysis: compares results
src/workflows/signal_opt.py - RL Training Workflow → RL Training Engine: delegates training
src/workflows/rl_train.py - Network Tools → OpenStreetMap: downloads map data
README.md - Network Tools → Eclipse SUMO: runs SUMO tools
src/mcp_tools/network.py - Demand Tools → Eclipse SUMO: runs SUMO tools
src/mcp_tools/route.py - Signal Optimization Tools → Eclipse SUMO: runs SUMO tools
src/mcp_tools/signal.py - Simulation Runner → Eclipse SUMO: runs simulation
src/mcp_tools/simulation.py - Vehicle Queries → TraCI Connection: uses connection
src/mcp_tools/vehicle.py - TraCI Connection → SUMO Discovery: locates binary
src/utils/connection.py - TraCI Connection → TraCI Helpers: controls session
src/utils/connection.py - Simulation Runner → TraCI Helpers: closes session
src/mcp_tools/simulation.py - Network Tools → Output Formatting: truncates output
src/mcp_tools/network.py - Demand Tools → Output Formatting: truncates output
src/mcp_tools/route.py - Signal Optimization Tools → Output Formatting: truncates output
src/mcp_tools/signal.py - Network Tools → Timeout Handling: runs with timeout
src/mcp_tools/network.py - Demand Tools → Timeout Handling: runs with timeout
src/mcp_tools/route.py - Signal Optimization Tools → Timeout Handling: runs with timeout
src/mcp_tools/signal.py - Simulation Runner → Timeout Handling: runs with adaptive timeout
src/mcp_tools/simulation.py