AgentSUMO — MCP-сервер для Claude Code: что делает и как установить
Связывает языковые модели с симулятором SUMO для сборки и запуска дорожных симуляций через обычные текстовые команды.
claude mcp add --env SUMO_HOME=<SUMO_HOME> --env AGENTSUMO_MCP_OUTPUT_BASE=<AGENTSUMO_MCP_OUTPUT_BASE> --transport stdio agentsumo -- uvx agentsumo-mcpЧто делает AgentSUMO
MCP-сервер даёт агенту 26 инструментов для транспортного моделирования. Сюда входят выгрузка графа из OpenStreetMap, конвертация сети, расчёт маршрутов и запуск симулятора. Для экспериментов с инфраструктурой предусмотрены перекрытие полос и корректировка фаз светофоров.
Сервер переводит выходные данные XML в SQLite. После этого формируются наглядные HTML-отчёты с анализом поездок. Дополнительно доступны тепловые карты нагрузки на дорожные сегменты.
Потребуется локальный пакет SUMO от версии 1.24 с переменной SUMO_HOME. Без бинарников симулятора запуск инструментов невозможен.
Какие задачи решает
- Собрать симуляционную сеть движения по данным OpenStreetMap
- Оценить влияние перекрытия полос или изменения светофоров на заторы
- Преобразовать выгрузки SUMO из формата XML в таблицы SQLite
- Сформировать отчёт с тепловой картой загрузки дорожных участков
Примеры запросов агенту
- Построй базовый сценарий движения в SUMO для центра района по данным OpenStreetMap
- Смоделируй перекрытие полосы на проспекте и покажи изменения задержек
- Переведи результаты последнего прогона из XML в SQLite и подготовь отчёт
Как установить AgentSUMO
Командой платформы
claude mcp add --env SUMO_HOME=<SUMO_HOME> --env AGENTSUMO_MCP_OUTPUT_BASE=<AGENTSUMO_MCP_OUTPUT_BASE> --transport stdio agentsumo -- uvx agentsumo-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agentsumo-mcp <команда>
Командой платформы
codex mcp add agentsumo --env SUMO_HOME=<SUMO_HOME> --env AGENTSUMO_MCP_OUTPUT_BASE=<AGENTSUMO_MCP_OUTPUT_BASE> -- uvx agentsumo-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agentsumo-mcp <команда>
Файл настроек
{
"mcpServers": {
"agentsumo": {
"command": "uvx",
"args": [
"agentsumo-mcp"
],
"env": {
"SUMO_HOME": "<SUMO_HOME>",
"AGENTSUMO_MCP_OUTPUT_BASE": "<AGENTSUMO_MCP_OUTPUT_BASE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agentsumo-mcp <команда>
Файл настроек
{
"servers": {
"agentsumo": {
"type": "stdio",
"command": "uvx",
"args": [
"agentsumo-mcp"
],
"env": {
"SUMO_HOME": "<SUMO_HOME>",
"AGENTSUMO_MCP_OUTPUT_BASE": "<AGENTSUMO_MCP_OUTPUT_BASE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agentsumo-mcp <команда>
Командой платформы
gemini mcp add -e SUMO_HOME=<SUMO_HOME> -e AGENTSUMO_MCP_OUTPUT_BASE=<AGENTSUMO_MCP_OUTPUT_BASE> agentsumo uvx agentsumo-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agentsumo-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о AgentSUMO
Как установить AgentSUMO в Claude Code?
Выполните команду claude mcp add agentsumo-mcp -e SUMO_HOME=<SUMO_HOME> -- uvx agentsumo-mcp, указав путь к каталогу с установленным SUMO.
Что делает MCP-сервер AgentSUMO?
Он позволяет ИИ-агенту генерировать дорожные сети, настраивать транспортные потоки, запускать расчёты SUMO и визуализировать заторы.
Что нужно подготовить перед запуском?
Нужны Python 3.10+ и локально установленный SUMO версии 1.24 или выше с заданной переменной SUMO_HOME.
