impeccable
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
MCP server for LLM-driven SUMO traffic simulation, scenario design, and result analysis.
この種の作業を AI に教える Skill。これと一緒に使えます
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.
Create beautiful slides on the web using a coding agent's frontend skills
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 13/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 25/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
AgentSUMO をインストールして。https://mcp.popnx.com/i/mw-jeong-agentsumo-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月17日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
設定を 1 項目入力 (SUMO_HOME) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server AgentSUMO を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "agentsumo": { "command": "uvx", "args": [ "agentsumo-mcp" ], "env": { "SUMO_HOME": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) SUMO_HOME は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、AgentSUMO のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
SUMO_HOME ローカルにインストールされた SUMO ディレクトリの絶対パス(bin/ を含む必要があります。tools/ はその直下か share/sumo/ 配下にあります)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
SettingsDeveloperEdit Config
{
"mcpServers": {
"agentsumo": {
"command": "uvx",
"args": [
"agentsumo-mcp"
],
"env": {
"SUMO_HOME": "your-value"
}
}
}
}AgentSUMO を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が AgentSUMO を使っていると言うか、回答に AgentSUMO のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
AGENTSUMO_MCP_OUTPUT_BASE シミュレーション出力(ネットワーク、トリップ、結果)のベースディレクトリ。既定値は現在の作業ディレクトリで、書き込めない場合は /agentsumo-output になります。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ AgentSUMO につなげません
AgentSUMO はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · AgentSUMO につなげるアプリを使う
B · デザイン・画像・音声 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
設定を 1 項目入力 (SUMO_HOME) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server AgentSUMO を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user agentsumo --env SUMO_HOME=your-value -- uvx agentsumo-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) SUMO_HOME は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、AgentSUMO のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
SUMO_HOME ローカルにインストールされた SUMO ディレクトリの絶対パス(bin/ を含む必要があります。tools/ はその直下か share/sumo/ 配下にあります)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user agentsumo --env SUMO_HOME=your-value -- uvx agentsumo-mcpAgentSUMO が一覧にあり、接続済みと表示されれば OK です
AgentSUMO を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が AgentSUMO を使っていると言うか、回答に AgentSUMO のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
AGENTSUMO_MCP_OUTPUT_BASE シミュレーション出力(ネットワーク、トリップ、結果)のベースディレクトリ。既定値は現在の作業ディレクトリで、書き込めない場合は /agentsumo-output になります。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
設定を 1 項目入力 (SUMO_HOME) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server AgentSUMO を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "agentsumo": { "command": "uvx", "args": [ "agentsumo-mcp" ], "env": { "SUMO_HOME": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) SUMO_HOME は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、AgentSUMO のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
SUMO_HOME ローカルにインストールされた SUMO ディレクトリの絶対パス(bin/ を含む必要があります。tools/ はその直下か share/sumo/ 配下にあります)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
AgentSUMO の設定で SUMO_HOME が空です。自分のキーを入れて保存します
AgentSUMO を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が AgentSUMO を使っていると言うか、回答に AgentSUMO のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
AGENTSUMO_MCP_OUTPUT_BASE シミュレーション出力(ネットワーク、トリップ、結果)のベースディレクトリ。既定値は現在の作業ディレクトリで、書き込めない場合は /agentsumo-output になります。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
設定を 1 項目入力 (SUMO_HOME) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server AgentSUMO を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "agentsumo": { "type": "stdio", "command": "uvx", "args": [ "agentsumo-mcp" ], "env": { "SUMO_HOME": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) SUMO_HOME は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、AgentSUMO のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
SUMO_HOME ローカルにインストールされた SUMO ディレクトリの絶対パス(bin/ を含む必要があります。tools/ はその直下か share/sumo/ 配下にあります)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
AgentSUMO の設定で SUMO_HOME が空です。自分のキーを入れて保存します
AgentSUMO を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が AgentSUMO を使っていると言うか、回答に AgentSUMO のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
AGENTSUMO_MCP_OUTPUT_BASE シミュレーション出力(ネットワーク、トリップ、結果)のベースディレクトリ。既定値は現在の作業ディレクトリで、書き込めない場合は /agentsumo-output になります。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user agentsumo --env SUMO_HOME=your-value -- uvx agentsumo-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"agentsumo": {
"command": "uvx",
"args": [
"agentsumo-mcp"
],
"env": {
"SUMO_HOME": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"agentsumo": {
"command": "uvx",
"args": [
"agentsumo-mcp"
],
"env": {
"SUMO_HOME": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"agentsumo": {
"type": "stdio",
"command": "uvx",
"args": [
"agentsumo-mcp"
],
"env": {
"SUMO_HOME": "your-value"
}
}
}
}SUMO_HOME 必須 envAGENTSUMO_MCP_OUTPUT_BASE env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント urban-ai-institute で確認済みです
コードの最終更新:一昨日
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
まだ確認していません
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/mw-jeong-agentsumo-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は一昨日、最新バージョン(0.1.3)がレジストリに届いたのは一昨日です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
同じカテゴリには:HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.
Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
The Figma MCP server brings Figma design context directly into your AI workflow.
Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.
| これ AgentSUMO | HyperFrames by HeyGen | Pascal 3D Editor | draw.io | Figma MCP Server | Remocn: Remotion MCP server | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドでもパソコンにインストールでも使える | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | はい | いいえ | いいえ | はい | いいえ |
| 基本チェック | 3/3 | 4/4 | 5/5 | 4/4 | 4/4 | 4/4 |
| ライセンス | MIT | Apache-2.0 | MIT | Apache-2.0 | – | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
An Agentic Framework for Interactive Simulation Scenario Generation in SUMO via Large Language Models
[Documentation](https://agentsumo.readthedocs.io) · Installation · Tools · Schema · Tutorials
AgentSUMO lets non-expert stakeholders design, execute, and analyze SUMO traffic simulations through natural-language interaction. The Planner Agent translates abstract policy questions into executable simulation plans, drives them via the Model Context Protocol (MCP), and surfaces results through a web dashboard.
*Web interface: conversational planning panel, scenario list, and live simulation status.*
*Geospatial visualization: per-edge metrics, congestion overlays, and trip replay on the 2.5D basemap.*
User (natural language)
| v Planner Agent (Claude LLM, Interactive Planning Protocol) | +--> AgentSUMO MCP Client --> AgentSUMO MCP Server (PyPI: agentsumo-mcp) --> SUMO | +--> SQLite MCP Client --> SQLite MCP Server (Anthropic, open source) --> simulations.db | +--> Filesystem MCP Client --> Filesystem MCP Server (Anthropic, open source) --> additional XML files
The reasoning layer (Planner Agent) lives in this repository. The execution layer (agentsumo-mcp) is published to PyPI and installed automatically as a dependency.
The AgentSUMO MCP Server exposes 26 tools grouped into five capability categories that follow the simulation workflow. Full reference at agentsumo.readthedocs.io/.../tools.
| Category | Purpose | Representative tools |
|---|---|---|
| Scenario Generation | Build a baseline SUMO simulation: OSM → network → trips → routes → run | osm_extract, net_convert, trip_generate, route_generate, sumo_runner |
| Policy Experimentation | Apply infrastructure, demand, and signal-control interventions | edge_edit_tool, reduce_lanes_tool, vehicle_generation_tool, flow_generation_tool, tls_offset_tool, tls_adaptation_tool |
| Result Analysis | Convert SUMO XML output to SQLite and render HTML reports | xml_to_sqlite_tool, simulation_report_tool |
| Visualization | Render networks, highlighted edges, and per-edge metric heatmaps | visualize_net_tool, visualize_edge_tool, visualize_policy_target_tool, visualize_edgedata_tool |
| Utility Functions | Network statistics, routing, road-name ↔ edge-id resolution, OD-coordinate validation, web-search grounding | network_summary_tool, route_analysis_tool, validate_od_coordinates_tool, web_search_tool |
SUMO_HOME set)npx on PATH, for the Filesystem MCP Server (@modelcontextprotocol/server-filesystem, downloaded by npx on first run). Without it the agent still starts, but cannot read the additional-file guides, write rerouter / VSS / vType files, or inspect Real OD CSVsweb_search_tool uses DuckDuckGoosmium-tool (brew install osmium-tool / sudo apt-get install osmium-tool). Only used when Overpass fails: the server then cuts the area from a Geofabrik .osm.pbf extractmacOS — Download the installer from the Eclipse SUMO downloads page, or use Homebrew. SUMO is not in Homebrew's core formulae; it comes from SUMO's own tap:
brew tap dlr-ts/sumo
brew install sumo
AgentSUMO runs SUMO headless, so the XQuartz setup the Homebrew formula mentions is only needed for `sumo-gui`.
Windows — Download the installer from the Eclipse SUMO downloads page.
Linux (Ubuntu/Debian)
sudo add-apt-repository ppa:sumo/stable
sudo apt-get update sudo apt-get install sumo sumo-tools sumo-doc
Install uv:
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Clone the repository, create a virtual environment, and install AgentSUMO:
git clone https://github.com/urban-ai-institute/kra35-prismx-agentsumo.git
cd kra35-prismx-agentsumo
uv venv --python 3.12
source .venv/bin/activate # macOS / Linux
uv pip install -e .
AgentSUMO reads API keys and the SUMO path from environment variables. The easiest way is a .env file at the project root:
cp .env.example .env
Open .env in your editor and fill in:
`ANTHROPIC_API_KEY` (required) — Claude API key that drives the Planner Agent. Get one at the Anthropic Console.
ANTHROPIC_API_KEY=[PopNx MCP ตัดค่าที่หน้าตาเหมือนกุญแจออก]
`MAPBOX_TOKEN` (required for the web UI) — used to render the basemap. Get one at the Mapbox access tokens page.
MAPBOX_TOKEN=pk.eyJ1Ijoixxxxxxxxxxxxxxxxxx
`SUMO_HOME` (required) — absolute path to your local SUMO installation. The directory must contain bin/sumo (or bin/sumo.exe on Windows).
# macOS (Homebrew): $(brew --prefix sumo)/share/sumo
SUMO_HOME=/opt/homebrew/opt/sumo/share/sumo
SUMO_HOME=/Library/Frameworks/EclipseSUMO.framework/Versions/ /EclipseSUMO # e.g. 1.24.0; use the directory name installed under Versions/
SUMO_HOME=C:\Program Files (x86)\Eclipse\Sumo
SUMO_HOME=/usr/share/sumo
`AGENTSUMO_MCP_OUTPUT_BASE` (optional) — override the base directory where the MCP server writes simulation outputs (networks, trips, results). Defaults to the current working directory, or ~/agentsumo-output when that directory is not writable (MCP hosts such as Claude Desktop often start servers in /).
AGENTSUMO_MCP_OUTPUT_BASE=/path/to/your/output/dir
# Web interface (opens at http://localhost:8000; needs MAPBOX_TOKEN)
python web.py # python web.py --port 8001 to use another port
python chat.py
python clean.py
On start the CLI prints Tools available: N: 26 AgentSUMO tools plus 14 Filesystem tools when Node.js is available. The six SQLite tools are added once a simulation database exists (after the first xml_to_sqlite_tool call).
Simulation outputs go to output/ under the directory you start from (or AGENTSUMO_MCP_OUTPUT_BASE). Start from the repository root so the MCP server runs the checkout's agentsumo_mcp rather than the PyPI copy.
AgentSUMO/
├── agentsumo/ │ ├── agent/ # Planner Agent (Claude orchestrator + prompts) │ ├── client/ # MCP clients (AgentSUMO, SQLite, Filesystem) │ └── core/ # Configuration ├── agentsumo_mcp/ # AgentSUMO MCP Server source (also published to PyPI) │ └── defaults/ # Packaged fixtures (e.g., vehicle_types.add.xml) ├── packaging/mcp/ # PyPI build configuration for agentsumo-mcp ├── web/ # Web interface (FastAPI + Jinja2 templates) ├── docs/ # Sphinx documentation source ├── tests/ # Unit tests ├── assets/ # README images ├── output/ # Runtime artifacts (auto-populated; 8 categories tracked │ # via .gitkeep — simulations/, networks/, trips/, │ # analysis/, reports/, uploads/, visualizations/, additional/) ├── chat.py # CLI entry point ├── clean.py # Deletes generated outputs ├── web.py # Web server entry point └── .env.example # Environment variable template
The AgentSUMO MCP Server can be used independently from this framework with any MCP-compatible LLM client (Claude Desktop, OpenAI tool clients, Gemini, local LLMs):
pip install agentsumo-mcp
Or via uvx without installing:
uvx agentsumo-mcp
The standalone server provides the 26 AgentSUMO tools only; the Planner Agent, the SQLite MCP Server and the Filesystem MCP Server belong to this framework. It needs SUMO_HOME, and writes outputs under AGENTSUMO_MCP_OUTPUT_BASE (default: the working directory, or ~/agentsumo-output when that is not writable). Claude Desktop (claude_desktop_config.json):
{
"mcpServers": { "agentsumo": { "command": "uvx", "args": ["agentsumo-mcp"], "env": { "SUMO_HOME": "/Library/Frameworks/EclipseSUMO.framework/Versions/Current/EclipseSUMO", "AGENTSUMO_MCP_OUTPUT_BASE": "/Users/you/agentsumo-output" } } } }
The server is registered in the official MCP Registry under io.github.mw-jeong/agentsumo-mcp.
SUMO path error — Verify SUMO_HOME in your .env. The directory must contain bin/sumo (or bin/sumo.exe on Windows).
API key error — Verify ANTHROPIC_API_KEY in your .env is set to a valid Claude API key. The Planner Agent will refuse to start without it.
`brew install sumo` says "No available formula" — Add SUMO's tap first: brew tap dlr-ts/sumo.
"Filesystem MCP could not start" warning — Install Node.js 18+ and make sure npx is on PATH. The first start downloads `@modelcontextprotocol/serve