Google Air Quality MCP

🚀 Google Air Quality MCP Server

このサーバーは、Model Context Protocol (MCP) を使用して、Googleの空気質APIにアクセスできるようにします。AIアシスタントが、リアルタイムの空気質データ、予測、過去の情報、ヒートマップの可視化を取得できるようになります。

✨ 主な機能

• 🌍 リアルタイムの空気質データ - 世界中の任意の場所の現在の空気質状況
• 📊 予測 - 毎時の空気質予測
• 📈 過去のデータ - 過去の空気質測定値にアクセス
• 🗺️ ヒートマップの可視化 - 空気質ヒートマップタイルを生成
• 🤖 LLMに適したプロンプト - 自然言語での場所のクエリ
• 📦 MCPリソース - URIテンプレートを介した構造化データへのアクセス

📦 インストール

前提条件

• Go 1.21 以上
• Google Air Quality APIキー（APIキーの設定 を参照）

インストール手順

1. リポジトリをクローンする

git clone git@github.com:ContexaAI/google-air-quality-mcp.git
cd google-air-quality-mcp

2. 依存関係をインストールする

go mod download

3. 環境変数を設定する

プロジェクトのルートに .env ファイルを作成します。

GOOGLE_AIR_QUALITY_API_KEY=your_api_key_here
MCP_SERVER_NAME=Google Air Quality MCP Server
PORT=8080

📚 ドキュメント

APIキーの設定

ステップ1: APIを有効にする

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. APIs & Services > Library に移動します。
4. "Air Quality API" を検索します。
5. Enable をクリックします。

ステップ2: API認証情報を作成する

1. APIs & Services > Credentials に移動します。
2. Create Credentials > API Key をクリックします。
3. 生成されたAPIキーをコピーします。
4. （推奨）Restrict Key をクリックし、以下の設定を行います。
   • API制限 で、"Restrict key" を選択します。
   • ドロップダウンから "Air Quality API" を選択します。
   • アプリケーション制限 で、IPアドレスやHTTPリファラーなどで制限を設定できます。

ステップ3: サーバーを設定する

APIキーを .env ファイルに追加します。

GOOGLE_AIR_QUALITY_API_KEY=AIzaSyD...your-key-here

⚠️ 重要提示

空気質APIを使用するには、Google Cloudプロジェクトで課金を有効にする必要がある場合があります。詳細は 料金ページ を確認してください。

使用方法

サーバーを起動する

go run cmd/server/main.go

サーバーは http://localhost:8080 で起動し、MCPエンドポイントは /mcp です。

MCPインスペクターで接続する

1. MCPインスペクター を開きます。
2. http://localhost:8080/mcp に接続します。
3. 利用可能なツール、プロンプト、リソースを探索します。

APIリファレンス

ツール

ヒートマップの有効なマップタイプ

• UAQI_RED_GREEN - 赤緑のカラーパレットを持つユニバーサルAQI
• UAQI_INDIGO_PERSIAN - インディゴペルシャンのパレットを持つユニバーサルAQI
• PM25_INDIGO_PERSIAN - PM2.5濃度のヒートマップ
• GBR_DEFRA - 英国のDEFRA指数
• DEU_UBA - ドイツのUBA指数
• CAN_EC - カナダのAQHI
• FRA_ATMO - フランスのATMO指数
• US_AQI - 米国のEPA AQI

プロンプト

リソース

サンプル

ツールの使用

サンフランシスコの現在の空気質を取得する:

{
  "name": "get_current_air_quality",
  "arguments": {
    "latitude": 37.7749,
    "longitude": -122.4194,
    "universalAqi": true
  }
}

ニューヨークの24時間の予測を取得する:

{
  "name": "get_air_quality_forecast",
  "arguments": {
    "latitude": 40.7128,
    "longitude": -74.0060,
    "pageSize": 24
  }
}

ロンドンの過去のデータを取得する:

{
  "name": "get_air_quality_history",
  "arguments": {
    "latitude": 51.5074,
    "longitude": -0.1278,
    "hours": 72
  }
}

プロンプトの使用

プロンプトを使用すると、自然言語で場所の名前を指定できます。LLMが自動的に座標に解決します。

プロンプトの使用例:

Use the current_air_quality_by_location_prompt with location "Tokyo, Japan"

LLMは以下の処理を行います。

1. "Tokyo, Japan" を座標 (35.6762, 139.6503) に解決します。
2. それらの座標で get_current_air_quality ツールを呼び出します。
3. 空気質データを返します。

リソースの使用

サーバー情報を読み取る:

URI: example://server-info

これは、サーバーの基本的な情報と利用可能なリソースを返します。

プロジェクト構造

.
├── cmd/
│   └── server/              # サーバーのエントリポイント
├── internal/
│   ├── capabilities/        # MCP機能
│   │   ├── prompts/        # プロンプトの定義とハンドラー
│   │   ├── resources/      # リソースの定義とハンドラー
│   │   └── tools/          # ツールの実装
│   │       ├── client.go   # Google Air Quality APIクライアント
│   │       ├── types.go    # 共有の型と構造体
│   │       ├── current_conditions.go
│   │       ├── forecast.go
│   │       ├── history.go
│   │       └── heatmap.go
│   ├── config/             # 設定管理
│   └── mcp/                # MCPサーバーのセットアップ
├── .env                    # 環境変数（git管理外）
├── .gitignore
├── go.mod
├── go.sum
└── README.md

開発

ビルド

go build -o bin/server cmd/server/main.go

実行

./bin/server

テスト

go test ./...

設定

環境変数（.env で設定）:

トラブルシューティング

APIキーの問題

エラー: "API key not valid"

• .env でAPIキーが正しいことを確認します。
• Google Cloud Consoleで空気質APIが有効になっていることを確認します。
• API制限（ある場合）があなたのIPからのリクエストを許可していることを確認します。

エラー: "This API method requires billing to be enabled"

• Google Cloudプロジェクトで課金を有効にします。
• 空気質APIには使用料がかかる場合があります。

接続の問題

エラー: "address already in use"

• 別のプロセスがポート8080を使用しています。
• プロセスを終了します: npx kill-port 8080
• または、.env で PORT を変更します。

📄 ライセンス

MIT

コントリビューション

コントリビューションは歓迎されます！プルリクエストを送信してください。

リソース

• Model Context Protocol Documentation
• Google Air Quality API Documentation
• MCP Go SDK
• MCP Inspector

サポート

問題や質問がある場合は、以下の方法で対応します。

• GitHub で問題を開いてください。
• Google Air Quality APIのドキュメント を確認してください。