Yaizu City Smart City

焼津市スマートシティ向けMCPサーバー - Claude Desktop/Code用のModel Context Protocolサーバー実装

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "moma1992-smartcity-mcp": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/smartcity-mcp",
        "run",
        "mcp/server.py"
      ],
      "env": {
        "YAIZU_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can access Yaizu City’s smart city data and services through a Model Context Protocol (MCP) server. This setup lets Claude Desktop and Claude Code query Yaizu’s API catalog, retrieve API details, generate commands, and run API requests against the Yaizu smart city data ecosystem in a streamlined, standards-based way.

How to use

Start the local MCP server and connect your MCP client to the Yaizu City Smart City MCP Server. Use your MCP client to query the API catalog, search for facilities or events, obtain API details, and run API commands generated for you. You can also log in to the Yaizu API portal and fetch the latest catalog and city data. Typical workflows include searching for disaster facilities, retrieving city data, and getting an up-to-date list of tourist spots.

How to install

Prerequisites you need on your machine are Python 3.13.7 or higher and uv 0.8.13 or higher.

Clone the MCP server repository and install dependencies, then set up your environment so the server can access the Yaizu API.

Step-by-step commands you should run in a terminal:

# Clone the MCP server repository
git clone https://github.com/moma1992/smartcity-mcp.git
cd smartcity-mcp

# Install dependencies
uv sync

# Copy and configure environment variables
cp .env.example .env
# Edit the .env file to set YAIZU_API_KEY and any other required keys

Additional notes

Claude Desktop configuration is used to run the MCP server locally. The following example shows how the MCP server can be wired for Claude Desktop. Adjust the paths to your environment.

{
  "mcpServers": {
    "yaizu_smartcity": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/smartcity-mcp",
        "run",
        "mcp/server.py"
      ]
    }
  }
}

Troubleshooting and tips

If you encounter authentication errors, ensure the YAIZU_API_KEY is set in your environment or in the .env file used by the MCP server.

If the server cannot be started from Claude Desktop, verify the configured paths for uv and the MCP server directory are correct and that Python dependencies are installed.

Available tools

search_api_docs

API specification search across 47 API specs to help you find the exact API you need.

get_api_details

Retrieve detailed information about a specific API endpoint.

generate_api_command

Automatically generate an MCP command tailored to the chosen API.

execute_yaizu_api

Execute a Yaizu City API request and return results.

get_yaizu_api_catalog

Fetch the API catalog for Yaizu City services.

get_yaizu_city_data

Obtain basic Yaizu City data for quick reference.

search_yaizu_facilities

Search Yaizu City facilities such as disaster facilities or public facilities.

login_yaizu_api_portal

Login to the Yaizu API portal to access restricted resources.