mcp_okinawa_api

# Overview An mcp server that integrates with APIs available from Okinawa Open Data. # Demo https://github.com/user-attachments/assets/8bd8d39b-41f4-453c-a884-3fb71a490f03 # Normal vs mcp <img width="500" alt="image" src="https://github.com/user-attachments/assets/ca7dbab8-56c8-487a-84ae-4018cecc6d12" /> <img width="500" alt="image" src="https://github.com/user-attachments/assets/a99d3e5d-b185-4091-992b-d7cd7a0886eb" /> # Architecture  # Setup Run the following commands: ``` uv init -p python3.11 uv venv source .venv/bin/activate uv sync ``` Configure the mcp client. The configuration file is located at: ``` code ~/Library/Application\ Support/Claude/claude_desktop_config.json ``` Copy and paste the following into the configuration file, but change `user_name` and `path`: ``` { "mcpServers": { "okinawa-tourism": { "command": "/Users/<user_name>/.local/bin/uv", "args": [ "--directory", "<path>", "run", "python", "main.py" ], "env": { "RESOURCE_ID": "<db_id>" } } } } ``` Get the path for the command using: ``` which uv ``` Get the path for the args using: ``` pwd ``` Retrieve the env ID from: https://odcs.bodik.jp/470007/ | Name | UUID | |-------------------------------------------|----------------------------------------| | List of Public Facilities in Okinawa | b621375e-0737-4de2-bf0f-c6a573f2ea85 | | List of Registered Stores for "Okinawa Ingredients" | 6d89d0fe-401f-4753-8548-4cc71c8ee5bf | | List of Educational Facilities | 999fd0ba-4588-4660-8855-559703434624 | | List of New Food Business Permits and Notifications | aee32ccf-01f7-439a-9789-20c329167ba0 |