MCP A0c

🚀 双源天気 MCP サーバー

このサーバーは、Model Context Protocol (MCP) に基づく天気サーバーです。和风天気と心知天気の API を使用して天気データを提供し、障害時のフェイルオーバーと最速応答の優先取得をサポートしています。

✨ 主な機能

• 現在の天気を確認する（リソースとして提供）
• 指定した都市の現在の天気を取得する（ツール）
• 指定した都市の天気予報を取得する（ツール）
• 複数の API ソースを同時に使用し、最速の応答結果を自動的に選択する
• 最低/最高気温、湿度、風速のデータをサポートする

📦 インストール

# リポジトリをクローンする
git clone <repository-url>
cd weather-mcp-server

# 依存関係をインストールする
npm install

# 環境変数を設定する
cp .env.example .env
# .env ファイルを編集し、あなたの API キーを追加する

API キーの取得

和风天気 API

1. 和风天気開発サービス にアクセスする
2. アカウントを登録し、アプリケーションを作成する
3. コンソールで API Key を取得する

心知天気 API

1. 心知天気開発サービス にアクセスする
2. アカウントを登録し、アプリケーションを作成する
3. コンソールで API Key を取得する

🚧 開発

# プロジェクトをビルドする
npm run build

# 監視モード（自動再構築）
npm run watch

▶️ 実行

npm start

🔧 MCP モードの説明

このサーバーは、Model Context Protocol (MCP) モードでのみ実行をサポートしており、HTTP サーバー機能は提供していません。MCP は、大規模言語モデル向けに設計されたプロトコルで、モデルが外部ツールやリソースとやり取りできるようにします。

MCP サーバーの特徴

• 標準入出力（stdio）を使用してクライアントと通信する
• 大規模言語モデルが使用するためのリソースとツールを提供する
• 構造化データの交換とエラー処理をサポートする

利用可能なリソース

• weather://{city} - 指定した都市の現在の天気を取得する

利用可能なツール

• getCurrentWeather - 指定した都市の現在の天気を取得する
• getForecast - 指定した都市の天気予報を取得する（1 - 7 日間をサポート）

Claude Desktop での設定

Claude Desktop の設定ファイルを編集します。

// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["あなたの完全パス/weather-mcp-server/build/index.js"],
      "env": {
        "QWEATHER_API_KEY": "あなたの和风天気 API キー",
        "SENIVERSE_API_KEY": "あなたの心知天気 API キー"
      }
    }
  }
}

🔍 デバッグ

MCP のログを確認します。

# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

MCP Inspector を使用したデバッグ

npx @modelcontextprotocol/inspector node あなたの完全パス/weather-mcp-server/build/index.js

その後、ブラウザで http://localhost:5173 にアクセスします。

🔄 障害時のフェイルオーバー機構

このサーバーは、複数の天気 API ソースを同時に使用します。

1. まず、和风天気と心知天気に並列でリクエストを送信します。
2. 最初に応答を返した API の結果を採用します。
3. ある API が失敗した場合、自動的に予備の API に切り替えます。
4. 最低/最高気温、湿度、風速のデータをサポートします。

📚 ドキュメント

• 設計文書
• 開発ガイド
• インターフェース仕様

🤝 コントリビューション

問題の報告やプルリクエストは大歓迎です！ 詳細は コントリビューションガイド を参照してください。

📄 ライセンス

MIT License

実行画面