焼津市スマートシティ 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で報告してください。

Yaizu Smart City MCP Server