agentsumo-mcp 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. agentsumo_mcp-0.1.0/LICENSE +22 -0
  2. agentsumo_mcp-0.1.0/PKG-INFO +160 -0
  3. agentsumo_mcp-0.1.0/README.md +102 -0
  4. agentsumo_mcp-0.1.0/agentsumo_mcp/__init__.py +9 -0
  5. agentsumo_mcp-0.1.0/agentsumo_mcp/analysis/__init__.py +12 -0
  6. agentsumo_mcp-0.1.0/agentsumo_mcp/analysis/xml_to_sqlite.py +718 -0
  7. agentsumo_mcp-0.1.0/agentsumo_mcp/baseline/__init__.py +20 -0
  8. agentsumo_mcp-0.1.0/agentsumo_mcp/baseline/net_converter.py +150 -0
  9. agentsumo_mcp-0.1.0/agentsumo_mcp/baseline/osm_extractor.py +258 -0
  10. agentsumo_mcp-0.1.0/agentsumo_mcp/baseline/route_generator.py +98 -0
  11. agentsumo_mcp-0.1.0/agentsumo_mcp/baseline/simulation_runner.py +630 -0
  12. agentsumo_mcp-0.1.0/agentsumo_mcp/baseline/trip_generator.py +310 -0
  13. agentsumo_mcp-0.1.0/agentsumo_mcp/customization/__init__.py +15 -0
  14. agentsumo_mcp-0.1.0/agentsumo_mcp/customization/network_editor.py +561 -0
  15. agentsumo_mcp-0.1.0/agentsumo_mcp/customization/traffic_lights.py +125 -0
  16. agentsumo_mcp-0.1.0/agentsumo_mcp/customization/vehicle_manager.py +500 -0
  17. agentsumo_mcp-0.1.0/agentsumo_mcp/main.py +1989 -0
  18. agentsumo_mcp-0.1.0/agentsumo_mcp/settings/__init__.py +21 -0
  19. agentsumo_mcp-0.1.0/agentsumo_mcp/settings/osmNetconvert_kr_urban.typ.xml +51 -0
  20. agentsumo_mcp-0.1.0/agentsumo_mcp/settings/settings.py +152 -0
  21. agentsumo_mcp-0.1.0/agentsumo_mcp/utils/__init__.py +21 -0
  22. agentsumo_mcp-0.1.0/agentsumo_mcp/utils/file_utils.py +121 -0
  23. agentsumo_mcp-0.1.0/agentsumo_mcp/utils/path_utils.py +60 -0
  24. agentsumo_mcp-0.1.0/agentsumo_mcp/utils/sumo_utils.py +715 -0
  25. agentsumo_mcp-0.1.0/agentsumo_mcp/visualization/__init__.py +15 -0
  26. agentsumo_mcp-0.1.0/agentsumo_mcp/visualization/data_plotter.py +257 -0
  27. agentsumo_mcp-0.1.0/agentsumo_mcp/visualization/edge_plotter.py +225 -0
  28. agentsumo_mcp-0.1.0/agentsumo_mcp/visualization/network_plotter.py +91 -0
  29. agentsumo_mcp-0.1.0/agentsumo_mcp.egg-info/PKG-INFO +160 -0
  30. agentsumo_mcp-0.1.0/agentsumo_mcp.egg-info/SOURCES.txt +34 -0
  31. agentsumo_mcp-0.1.0/agentsumo_mcp.egg-info/dependency_links.txt +1 -0
  32. agentsumo_mcp-0.1.0/agentsumo_mcp.egg-info/entry_points.txt +2 -0
  33. agentsumo_mcp-0.1.0/agentsumo_mcp.egg-info/requires.txt +9 -0
  34. agentsumo_mcp-0.1.0/agentsumo_mcp.egg-info/top_level.txt +1 -0
  35. agentsumo_mcp-0.1.0/pyproject.toml +57 -0
  36. agentsumo_mcp-0.1.0/setup.cfg +4 -0
@@ -0,0 +1,22 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Minwoo Jeong, Jeeyun Chang, Yoonjin Yoon
4
+ KAIST Graduate School of Data Science
5
+
6
+ Permission is hereby granted, free of charge, to any person obtaining a copy
7
+ of this software and associated documentation files (the "Software"), to deal
8
+ in the Software without restriction, including without limitation the rights
9
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
+ copies of the Software, and to permit persons to whom the Software is
11
+ furnished to do so, subject to the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be included in
14
+ all copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
+ SOFTWARE.
@@ -0,0 +1,160 @@
1
+ Metadata-Version: 2.4
2
+ Name: agentsumo-mcp
3
+ Version: 0.1.0
4
+ Summary: MCP server for SUMO traffic simulation: orchestrate networks, trips, simulations, and analysis from LLM agents.
5
+ Author: Minwoo Jeong, Jeeyun Chang, Yoonjin Yoon
6
+ License: MIT License
7
+
8
+ Copyright (c) 2026 Minwoo Jeong, Jeeyun Chang, Yoonjin Yoon
9
+ KAIST Graduate School of Data Science
10
+
11
+ Permission is hereby granted, free of charge, to any person obtaining a copy
12
+ of this software and associated documentation files (the "Software"), to deal
13
+ in the Software without restriction, including without limitation the rights
14
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
15
+ copies of the Software, and to permit persons to whom the Software is
16
+ furnished to do so, subject to the following conditions:
17
+
18
+ The above copyright notice and this permission notice shall be included in
19
+ all copies or substantial portions of the Software.
20
+
21
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
24
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
26
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
27
+ SOFTWARE.
28
+
29
+ Project-URL: Homepage, https://github.com/mw-jeong/AgentSUMO
30
+ Project-URL: Documentation, https://agentsumo.readthedocs.io
31
+ Project-URL: Repository, https://github.com/mw-jeong/AgentSUMO
32
+ Project-URL: Issues, https://github.com/mw-jeong/AgentSUMO/issues
33
+ Keywords: mcp,sumo,traffic-simulation,llm,agent,anthropic
34
+ Classifier: Development Status :: 4 - Beta
35
+ Classifier: Intended Audience :: Developers
36
+ Classifier: Intended Audience :: Science/Research
37
+ Classifier: License :: OSI Approved :: MIT License
38
+ Classifier: Operating System :: OS Independent
39
+ Classifier: Programming Language :: Python :: 3
40
+ Classifier: Programming Language :: Python :: 3.10
41
+ Classifier: Programming Language :: Python :: 3.11
42
+ Classifier: Programming Language :: Python :: 3.12
43
+ Classifier: Topic :: Scientific/Engineering
44
+ Classifier: Topic :: Scientific/Engineering :: GIS
45
+ Requires-Python: >=3.10
46
+ Description-Content-Type: text/markdown
47
+ License-File: LICENSE
48
+ Requires-Dist: mcp[cli]>=1.13.1
49
+ Requires-Dist: sumolib>=1.24.0
50
+ Requires-Dist: geopy>=2.4.1
51
+ Requires-Dist: geopandas<0.15.0,>=0.14.3
52
+ Requires-Dist: pandas>=2.3.2
53
+ Requires-Dist: shapely>=2.1.1
54
+ Requires-Dist: pyproj>=3.6.0
55
+ Requires-Dist: lxml>=5.0.0
56
+ Requires-Dist: ddgs>=9.0.0
57
+ Dynamic: license-file
58
+
59
+ <!-- mcp-name: io.github.mw-jeong/agentsumo-mcp -->
60
+
61
+ # agentsumo-mcp
62
+
63
+ [![PyPI](https://img.shields.io/pypi/v/agentsumo-mcp.svg)](https://pypi.org/project/agentsumo-mcp/)
64
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
65
+ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
66
+
67
+ MCP server for [SUMO](https://www.eclipse.org/sumo/) (Simulation of Urban MObility) traffic simulation. Orchestrate network extraction, trip generation, scenario customization, simulation runs, and SQL-based result analysis from any MCP-compatible LLM client.
68
+
69
+ ## Features
70
+
71
+ - **Pipeline tools**: OSM extraction -> network conversion -> trip generation -> route generation -> simulation
72
+ - **Scenario customization**: edge editing, lane reduction, speed limit changes, vehicle generation, traffic-light timing
73
+ - **Result analysis**: ingest tripinfo / edgedata / summary XML into SQLite for natural-language SQL queries
74
+ - **Visualization**: network plots, edge data heatmaps, policy-target visualizations
75
+ - **Geocoding**: place name -> coordinate -> nearest edge resolution
76
+
77
+ ## Requirements
78
+
79
+ - Python 3.10 or later
80
+ - [SUMO](https://eclipse.dev/sumo/) installed locally (`SUMO_HOME` environment variable set)
81
+
82
+ ## Installation
83
+
84
+ ```bash
85
+ pip install agentsumo-mcp
86
+ ```
87
+
88
+ Or run without installing via [`uvx`](https://docs.astral.sh/uv/guides/tools/):
89
+
90
+ ```bash
91
+ uvx agentsumo-mcp
92
+ ```
93
+
94
+ ## Configuration
95
+
96
+ Set `SUMO_HOME` to point at your local SUMO installation:
97
+
98
+ ```bash
99
+ export SUMO_HOME=/path/to/sumo
100
+ ```
101
+
102
+ On macOS with the official SUMO installer this is usually `/Library/Frameworks/EclipseSUMO.framework/Versions/<version>/EclipseSUMO`.
103
+
104
+ ## Usage with Claude Desktop
105
+
106
+ Add to your `claude_desktop_config.json`:
107
+
108
+ ```json
109
+ {
110
+ "mcpServers": {
111
+ "agentsumo": {
112
+ "command": "uvx",
113
+ "args": ["agentsumo-mcp"],
114
+ "env": {
115
+ "SUMO_HOME": "/path/to/sumo"
116
+ }
117
+ }
118
+ }
119
+ }
120
+ ```
121
+
122
+ ## Usage with other MCP clients
123
+
124
+ Any MCP client that supports stdio transport works:
125
+
126
+ ```bash
127
+ agentsumo-mcp
128
+ ```
129
+
130
+ ## Tools
131
+
132
+ The server exposes ~25 tools across five categories:
133
+
134
+ | Category | Examples |
135
+ |----------|----------|
136
+ | Network | `osm_extract`, `net_convert`, `network_summary_tool` |
137
+ | Trips & routes | `trip_generate`, `route_generate`, `vehicle_generation_tool`, `flow_generation_tool` |
138
+ | Customization | `edge_edit_tool`, `reduce_lanes_tool`, `speed_limit_edit_tool`, `tls_offset_tool`, `tls_adaptation_tool` |
139
+ | Simulation | `sumo_runner` |
140
+ | Analysis | `xml_to_sqlite_tool`, `simulation_report_tool`, `route_analysis_tool`, `analyze_road_details_tool` |
141
+ | Visualization | `visualize_net_tool`, `visualize_edge_tool`, `visualize_edgedata_tool` |
142
+
143
+ Each tool returns structured JSON suitable for downstream LLM reasoning.
144
+
145
+ ## Citation
146
+
147
+ If you use AgentSUMO in academic work, please cite:
148
+
149
+ ```bibtex
150
+ @software{agentsumo2026,
151
+ author = {Jeong, Minwoo and Chang, Jeeyun and Yoon, Yoonjin},
152
+ title = {AgentSUMO: an MCP-based agentic framework for SUMO traffic simulation},
153
+ year = {2026},
154
+ url = {https://github.com/mw-jeong/AgentSUMO}
155
+ }
156
+ ```
157
+
158
+ ## License
159
+
160
+ MIT. See [LICENSE](LICENSE).
@@ -0,0 +1,102 @@
1
+ <!-- mcp-name: io.github.mw-jeong/agentsumo-mcp -->
2
+
3
+ # agentsumo-mcp
4
+
5
+ [![PyPI](https://img.shields.io/pypi/v/agentsumo-mcp.svg)](https://pypi.org/project/agentsumo-mcp/)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7
+ [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
8
+
9
+ MCP server for [SUMO](https://www.eclipse.org/sumo/) (Simulation of Urban MObility) traffic simulation. Orchestrate network extraction, trip generation, scenario customization, simulation runs, and SQL-based result analysis from any MCP-compatible LLM client.
10
+
11
+ ## Features
12
+
13
+ - **Pipeline tools**: OSM extraction -> network conversion -> trip generation -> route generation -> simulation
14
+ - **Scenario customization**: edge editing, lane reduction, speed limit changes, vehicle generation, traffic-light timing
15
+ - **Result analysis**: ingest tripinfo / edgedata / summary XML into SQLite for natural-language SQL queries
16
+ - **Visualization**: network plots, edge data heatmaps, policy-target visualizations
17
+ - **Geocoding**: place name -> coordinate -> nearest edge resolution
18
+
19
+ ## Requirements
20
+
21
+ - Python 3.10 or later
22
+ - [SUMO](https://eclipse.dev/sumo/) installed locally (`SUMO_HOME` environment variable set)
23
+
24
+ ## Installation
25
+
26
+ ```bash
27
+ pip install agentsumo-mcp
28
+ ```
29
+
30
+ Or run without installing via [`uvx`](https://docs.astral.sh/uv/guides/tools/):
31
+
32
+ ```bash
33
+ uvx agentsumo-mcp
34
+ ```
35
+
36
+ ## Configuration
37
+
38
+ Set `SUMO_HOME` to point at your local SUMO installation:
39
+
40
+ ```bash
41
+ export SUMO_HOME=/path/to/sumo
42
+ ```
43
+
44
+ On macOS with the official SUMO installer this is usually `/Library/Frameworks/EclipseSUMO.framework/Versions/<version>/EclipseSUMO`.
45
+
46
+ ## Usage with Claude Desktop
47
+
48
+ Add to your `claude_desktop_config.json`:
49
+
50
+ ```json
51
+ {
52
+ "mcpServers": {
53
+ "agentsumo": {
54
+ "command": "uvx",
55
+ "args": ["agentsumo-mcp"],
56
+ "env": {
57
+ "SUMO_HOME": "/path/to/sumo"
58
+ }
59
+ }
60
+ }
61
+ }
62
+ ```
63
+
64
+ ## Usage with other MCP clients
65
+
66
+ Any MCP client that supports stdio transport works:
67
+
68
+ ```bash
69
+ agentsumo-mcp
70
+ ```
71
+
72
+ ## Tools
73
+
74
+ The server exposes ~25 tools across five categories:
75
+
76
+ | Category | Examples |
77
+ |----------|----------|
78
+ | Network | `osm_extract`, `net_convert`, `network_summary_tool` |
79
+ | Trips & routes | `trip_generate`, `route_generate`, `vehicle_generation_tool`, `flow_generation_tool` |
80
+ | Customization | `edge_edit_tool`, `reduce_lanes_tool`, `speed_limit_edit_tool`, `tls_offset_tool`, `tls_adaptation_tool` |
81
+ | Simulation | `sumo_runner` |
82
+ | Analysis | `xml_to_sqlite_tool`, `simulation_report_tool`, `route_analysis_tool`, `analyze_road_details_tool` |
83
+ | Visualization | `visualize_net_tool`, `visualize_edge_tool`, `visualize_edgedata_tool` |
84
+
85
+ Each tool returns structured JSON suitable for downstream LLM reasoning.
86
+
87
+ ## Citation
88
+
89
+ If you use AgentSUMO in academic work, please cite:
90
+
91
+ ```bibtex
92
+ @software{agentsumo2026,
93
+ author = {Jeong, Minwoo and Chang, Jeeyun and Yoon, Yoonjin},
94
+ title = {AgentSUMO: an MCP-based agentic framework for SUMO traffic simulation},
95
+ year = {2026},
96
+ url = {https://github.com/mw-jeong/AgentSUMO}
97
+ }
98
+ ```
99
+
100
+ ## License
101
+
102
+ MIT. See [LICENSE](LICENSE).
@@ -0,0 +1,9 @@
1
+ """
2
+ AgentSUMO MCP Server
3
+
4
+ Provides MCP tools for SUMO traffic simulation.
5
+ """
6
+
7
+ from .main import mcp
8
+
9
+ __all__ = ["mcp"]
@@ -0,0 +1,12 @@
1
+ """
2
+ AgentSUMO Server - Analysis Module
3
+
4
+ Simulation result parsing and SQL ingestion.
5
+ """
6
+
7
+ from .xml_to_sqlite import XMLToSQLiteConverter, extract_tag_from_xml
8
+
9
+ __all__ = [
10
+ "XMLToSQLiteConverter",
11
+ "extract_tag_from_xml",
12
+ ]