MLIT-DATA-PLATFORM-mcp

# Land Transportation Data Platform MCP Server The MCP (Model Context Protocol) server that searches for land transportation data using the Land Transportation Ministry's Land Transportation Data Platform API. ## Features - Searching and retrieving data with specified conditions - Retrieving data based on data ID - Retrieving data catalog and dataset information - Retrieving a list of prefecture codes and corresponding prefecture names - Retrieving a list of municipality codes and corresponding municipality names ## Available Tools #### 1. search Search and retrieve data by specifying keywords #### 2. search_by_location_rectangle Search and retrieve data by specifying keywords and a range using latitude and longitude #### 3. search_by_location_point_distance Search and retrieve data by specifying keywords, center latitude and longitude, and radius distance (in meters) #### 4. search_by_attribute Search and retrieve data by specifying keywords and attribute information #### 5. get_data_summary Retrieve only summary information of data by specifying data ID #### 6. get_data Retrieve detailed information of data by specifying data ID #### 7. get_data_catalog Retrieve data catalog and dataset information #### 8. get_prefecture_data Retrieve a list of prefecture codes and corresponding prefecture names used in the Land Transportation Data Platform #### 9. get_municipality_data Retrieve a list of municipality codes and corresponding municipality names used in the Land Transportation Data Platform ## Dependencies pip install aiohttp mcp ## Usage (steps to operate in your environment) When using by cloning locally: ```bash # Clone the repository git clone https://github.com/hrko9gis/MLIT-DATA-PLATFORM-mcp.git cd MLIT-DATA-PLATFORM-mcp # Use Python virtual environment uv venv .venv\Scripts\activate pip install aiohttp mcp ``` ## Usage in Claude Desktop (if the path is available, it is expected to work without issues) You can add and use the MCP server in Claude Desktop. 1. Open the settings screen in Claude Desktop 2. Add this MCP server ```json { "mcpServers": { "MLIT-DATA-PLATFORM-mcp": { "command": "uv", "args": [ "--directory", "<absolute path to the directory where mlit-data-platform-mcp.py exists>", "run", "mlit-data-platform-mcp.py" ] } } } ``` 3. Save 4. Connect ## Usage in Claude Desktop (settings that worked in your environment) You can add and use the MCP server in Claude Desktop. 1. Open the settings screen in Claude Desktop 2. Add this MCP server ```json { "mcpServers": { "MLIT-DATA-PLATFORM-mcp": { "command": "<absolute path to the MLIT-DATA-PLATFORM-mcp directory>\\venv\\Scripts\\python.exe", "args": ["<absolute path to the MLIT-DATA-PLATFORM-mcp directory>\\mlit-data-platform-mcp.py"] } } } ``` 3. Save 4. Connect ## Required Dependencies pip install aiohttp mcp ## API Key - Land Transportation Data Platform API key for users ([refer to API usage method](https://www.reinfolib.mlit.go.jp/help/apiManual/#titleApiApplication)) ## License MIT ## Acknowledgments This project uses the Land Transportation Ministry's Land Transportation Data Platform API. We appreciate the provision of the API.