SUMO

SUMO-MCP is a middleware that seamlessly connects large language models (LLMs) with the Eclipse SUMO traffic simulation framework. By utilizing the Model Context Protocol (MCP), it empowers AI agents such as Claude, Cursor, and TRAE to directly access SUMO's core functionalities, enabling a fully automated workflow that ranges from OpenStreetMap data retrieval to network generation, demand modeling, simulation execution, and signal optimization. Developers can leverage this integration to enhance their traffic modeling and simulation tasks with AI-driven insights.

Once connected to the SUMO-MCP server, you can interact with it using specific commands tailored to your needs. You can issue queries to pull traffic data, generate road networks, or initiate simulations directly from your AI agent. The server is designed to facilitate real-time communication and can handle commands related to demand modeling and signal optimization, ensuring an efficient simulation process. Familiarizing yourself with the MCP command structure will enhance your interaction with the server.

To install the SUMO-MCP server, ensure you have the following prerequisites:

• Node.js (version 14 or higher)
• Python (version 3.6 or higher)

Option A: Quick start with npx

If you prefer a quick start, you can use npx (though the package may not be published):

npx -y @XRDS76354/SUMO-MCP-Server

Option B: Global install alternative

Alternatively, you can clone the repository and install it globally:

git clone https://github.com/XRDS76354/SUMO-MCP-Server.git
cd SUMO-MCP-Server
npm install -g

Make sure to run the server with appropriate permissions to allow for necessary resource access.

For optimal performance, consider configuring the server with appropriate environment variables, especially for network settings and simulation parameters. Ensure you have the latest version of Eclipse SUMO installed and that it is properly set up in your environment. A common issue arises when the server cannot find the SUMO executable; make sure the path is correctly configured in your environment variables.