Yaizu Smart City MCP Server

焼津市スマートシティ MCP サーバー

焼津市のオープンデータを活用したModel Context Protocol (MCP) サーバー。Claude Desktop および Claude Code から焼津市スマートシティAPIへのアクセスを提供します。

特徴

提供ツール

search_api_docs: API仕様検索機能 - 47種類のAPI仕様書から検索
get_api_details: API詳細情報取得
generate_api_command: APIコマンド自動生成
execute_yaizu_api: 焼津市API実行
get_yaizu_api_catalog: APIカタログ取得
get_yaizu_city_data: 焼津市基本データ取得
search_yaizu_facilities: 施設検索
login_yaizu_api_portal: APIポータルログイン

提供リソース

yaizu://info: 焼津市情報
yaizu://status: MCPサーバー状態
yaizu://catalog-summary: APIカタログサマリー
yaizu://catalog-detailed: APIカタログ詳細

インストール

必要要件

Python 3.13.7 以上
uv 0.8.13 以上

セットアップ

# リポジトリのクローン
git clone https://github.com/moma1992/smartcity-mcp.git
cd smartcity-mcp

# 依存関係のインストール
uv sync

# 環境変数の設定
cp .env.example .env
# .envファイルを編集してAPIキーを設定

Claude Desktop 設定

Claude Desktop の設定ファイルを開く:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
以下の設定を追加:

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

パスを実際の環境に合わせて修正

使用方法

開発・デバッグ

# MCP Inspector で開発サーバー起動
uv run mcp dev mcp/server.py

# 直接実行
uv run python mcp/server.py

# 統合テスト実行
uv run python tests/test_mcp_integration.py

Claude Desktop での使用

Claude Desktop を起動後、以下のようなコマンドが使用可能:

焼津市のイベント情報を検索して

防災施設を検索して

観光スポットの一覧を取得して

プロジェクト構成

smartcity-mcp/
├── mcp/
│   ├── server.py        # MCPサーバー本体
│   └── scraper.py       # APIカタログスクレイピング
├── scripts/
│   ├── pdf_to_json_generator.py  # PDF→JSON変換
│   └── ...              # その他のデータ処理スクリプト
├── tests/
│   └── test_mcp_integration.py   # 統合テスト
├── data/
│   ├── api_specs/       # 47種類のAPI仕様書（JSON）
│   ├── documentation/   # PDFドキュメント
│   └── openapi/         # OpenAPI仕様書
├── pyproject.toml       # プロジェクト設定
├── CLAUDE.md            # Claude用開発ガイド
└── README.md            # このファイル

API 仕様

焼津市API

基本URL: https://api.smartcity-yaizu.jp/v2/entities
認証: APIキー（apikeyヘッダー）
形式: FIWARE NGSIv2

対応エンティティ（一部）

防災情報: Aed, EvacuationShelter, DisasterMail
観光情報: Event, TouristAttraction, SightseeingMapStore
環境情報: PrecipitationGauge, WaterLevelGauge
公共施設: PublicFacility, HospitalAndClinic

技術スタック

フレームワーク: FastMCP (MCP Python SDK)
非同期処理: asyncio
HTTPクライアント: aiohttp, httpx
PDF処理: PyMuPDF, PyPDF2
環境管理: python-dotenv
パッケージ管理: uv

トラブルシューティング

エラー: "No API key found"

→ .envファイルにYAIZU_API_KEYを設定してください

エラー: "Server disconnected"

→ Claude Desktop設定のパスを確認してください

エラー: "Module not found"

→ uv syncで依存関係をインストールしてください

ライセンス

MIT License

貢献

Issues や Pull Request を歓迎します。

サポート

問題が発生した場合は、Issuesで報告してください。