焼津市スマートシティ 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
- macOS:
-
以下の設定を追加:
{
"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で報告してください。