Valencia Smart City MCP Server

Valencia Smart City MCP Server

Claude やほかの LLM 向けに、スペインのバレンシアのリアルタイムの交通、自転車シェアリング、大気質、気象データを提供する MCP サーバーです。

特長

• バレンシア全域のリアルタイム交通状況
• Valenbisi の自転車ステーションの利用状況
• 市内の観測所から取得した大気質モニタリングデータ
• Open-Meteo API による気象データ（現在、予報、過去）
• 交通渋滞の分析
• 特定の道路、自転車ステーション、大気質情報の検索機能

デモ

Claude Desktop で MCP の動作を確認できるライブデモをご覧ください。

大気質： Claude MCP Demo Chat Air quality

自転車シェアリング（Valenbisi）： Claude MCP Demo Chat Valenbisi

交通： Claude MCP Demo Chat Traffic

気象： Claude MCP Demo Chat Weather

この共有された会話では、MCP を通じて Claude がバレンシアの都市データにリアルタイムでアクセスし、分析する方法を紹介しています。

要件

• Python 3.10+
• Claude Desktop またはその他の MCP 対応クライアント
• インターネット接続

インストール

# Clone the repository
git clone https://github.com/sosanzma/SmartCityMCP.git
cd SmartCityMCP

# Install dependencies
pip install -r requirements.txt

ツール

サーバーは次のツールを公開しています。

交通ツール

• get_traffic_status

  • 道路区間の現在の交通状況を取得します
  • 入力：state_filter（省略可能、integer[]） - 交通状態コードで絞り込みます
  • 戻り値：交通状態を含む道路区間の一覧

• get_congestion_summary

  • バレンシアの現在の交通渋滞の概要を取得します
  • 戻り値：渋滞している区間や割合などの統計情報

• search_road_segment

  • 名前で特定の道路区間を検索します
  • 入力：name_query（string） - 大文字と小文字を区別しない検索語
  • 戻り値：現在の状態を含む、検索条件に一致する道路区間の一覧

自転車シェアリングツール

• find_available_bikes

  • 利用可能な自転車があるステーションを検索します
  • 入力：
    • min_bikes（integer、既定値：1） - 必要な自転車の最小台数
    • near_address（string、省略可能） - 周辺を検索する住所
  • 戻り値：条件に一致するステーションの一覧と利用状況

• get_bike_station_status

  • 自転車ステーションの詳細な状況を取得します
  • 入力：station_id（string、省略可能） - 特定のステーションを指定します
  • 戻り値：利用可能な自転車台数や空きスロットを含む詳細な状況

大気質ツール

• get_air_quality_summary

  • バレンシア全域の大気質の概要を取得します
  • 戻り値：汚染物質の濃度と大気質評価の統計概要

• find_nearest_air_station

  • 指定した座標に最も近い大気質モニタリングステーションを検索します
  • 入力：
    • latitude（float） - 緯度座標
    • longitude（float） - 経度座標
  • 戻り値：距離と現在の測定値を含む、最寄りのステーションの詳細

• get_station_data

  • 大気質モニタリングステーションの詳細情報を取得します
  • 入力：station_name（string） - 検索する名前（一部一致）
  • 戻り値：一致するステーションの汚染物質に関する詳細データ

• get_pollutant_levels

  • すべてのステーションにおける特定の汚染物質の濃度を取得します
  • 入力：pollutant（string） - 汚染物質の種類（so2、no2、o3、co、pm10、pm25）
  • 戻り値：指定した汚染物質の測定値と統計情報

• get_air_quality_map

  • 地図表示用の大気質ステーションの地理空間データを取得します
  • 戻り値：大気質評価と汚染物質の濃度を含む位置データ

天気ツール

• get_current_weather

  • バレンシアの現在の天気を取得します
  • 戻り値：気温、湿度、風速、天気の説明などの現在の天気データ

• get_weather_forecast

  • バレンシアの天気予報を取得します
  • 入力：days（整数、デフォルト：3）- 予報する日数（1～7）
  • 戻り値：指定した期間の時間ごとの天気予報

• get_historical_weather

  • バレンシアの過去の天気データを取得します
  • 入力：
    • start_date（文字列）- YYYY-MM-DD 形式の開始日
    • end_date（文字列）- YYYY-MM-DD 形式の終了日
  • 戻り値：指定した期間の過去の天気データ

• get_daily_weather_summary

  • バレンシアの日ごとの天気の概要を取得します
  • 入力：day_offset（整数、デフォルト：0）- 日数のオフセット（0＝今日、1＝明日など）
  • 戻り値：最低・最高・平均値を含む日ごとの天気の概要

Claude Desktop との連携

claude_desktop_config.json に以下を追加します（通常、Windows では %APPDATA%\Claude、macOS では ~/Library/Application Support/Claude にあります）。

{
  "mcpServers": {
    "valenciaSmartCity": {
      "command": "uv",
      "args": ["run", "valencia_traffic_mcp.py"]
    }
  }
}

または、以下のコマンドで直接インストールします。

mcp install valencia_traffic_mcp.py --name "Valencia Smart City"

開発

サーバーを直接実行します。

# Run with MCP Inspector for development
mcp dev valencia_traffic_mcp.py

# Run directly (stdio transport)
python valencia_traffic_mcp.py

クエリの例

• 「バレンシアの現在の交通状況はどうですか？」
• 「バレンシア中心部で渋滞している通りはありますか？」
• 「市庁舎の近くで Valenbisi の自転車を借りられる場所はどこですか？」
• 「今日のバレンシアの空気質はどうですか？」
• 「バレンシアで最も汚染レベルが高い地域はどこですか？」
• 「駅に最も近い空気質監視局はどこですか？」
• 「バレンシア全域の NO2 濃度を表示してください」
• 「今週のバレンシアの天気予報はどうですか？」
• 「明日のバレンシアは雨が降りますか？」
• 「先週のバレンシアの気温は何度でしたか？」
• 「今日のバレンシアはサイクリングに適した日ですか？」

データソース

このサーバーは以下のデータソースに接続します。

• バレンシアのオープンデータプラットフォーム：

  • 交通データ：estat-transit-temps-real-estado-trafico-tiempo-real
  • 自転車ステーション：valenbisi-disponibilitat-valenbisi-disponibilidad
  • 空気質：estacions-contaminacio-atmosferiques-estaciones-contaminacion-atmosfericas

• Open-Meteo API：

  • 現在の天気データ
  • 天気予報
  • 過去の天気データ

ライセンス

MIT