Caiyun MCP Tools

🚀 酷云天气 MCP サーバー

このサーバーは、酷云天気 API 用のモデルコンテキストプロトコル（MCP）サーバーです。リアルタイムの天気状況、予報、天気警報などの天気データにアクセスするためのツールを提供します。

✨ 主な機能

• リアルタイムの天気状況
• 毎時の天気予報（最大72時間）
• 毎日の天気予報（最大7日間）
• 天気警報
• 複数言語対応（中国語、英語、日本語）
• トークンを節約するコンパクトなレスポンス形式

📦 インストール

前提条件

• Node.js（v16以上）
• 酷云天気 API トークン（Caiyun Weather API ドキュメントから取得）

設定

{
  "mcpServers": {
    "caiyun-mcp-tools": {
      "command": "npx",
      "args": [
        "caiyun-mcp-tools"
      ],
      "env": {
        "CAIYUN_API_KEY": "your-caiyun-api-key"
      }
    }
  }
}

利用可能なツール

Cursor を通じて以下のツールにアクセスできます。

1. realtime-weather - 現在の天気状況を取得

   • パラメータ：
     • longitude (number): 経度座標
     • latitude (number): 緯度座標
     • lang (オプションの文字列): レスポンスの言語（"zh_CN"、"en_US" または "ja"）、デフォルトは "zh_CN"

2. hourly-forecast - 毎時の天気予報を取得

   • パラメータ：
     • longitude (number): 経度座標
     • latitude (number): 緯度座標
     • hourlysteps (オプションの数値): 返される毎時予報の数（最大値：72）
     • lang (オプションの文字列): レスポンスの言語（"zh_CN"、"en_US" または "ja"）、デフォルトは "zh_CN"

3. daily-forecast - 毎日の天気予報を取得

   • パラメータ：
     • longitude (number): 経度座標
     • latitude (number): 緯度座標
     • dailysteps (オプションの数値): 返される毎日予報の数（最大値：7）
     • lang (オプションの文字列): レスポンスの言語（"zh_CN"、"en_US" または "ja"）、デフォルトは "zh_CN"

4. weather-alerts - 有効な天気警報を取得

   • パラメータ：
     • longitude (number): 経度座標
     • latitude (number): 緯度座標
     • lang (オプションの文字列): レスポンスの言語（"zh_CN"、"en_US" または "ja"）、デフォルトは "zh_CN"

📚 ドキュメント

API 制限

公式の酷云天気 API ドキュメントによると、「API インターフェースは過去1日分の履歴データのみを返すことができます。」この制限により、履歴天気ツールはこのパッケージから削除されました。

🤝 コントリビューション

皆さんからのコントリビューションを歓迎します！Pull Request をいつでも送信してください。

📄 ライセンス

MIT