hko_mcp

mcp-hko（香港天文台 MCP サーバー）

この MCP サーバーは、香港天文台の気象データ API へのアクセスを提供します。 クライアントが Model Context Protocol を通じて、天気予報、地震情報、潮汐データ、その他の気象情報を取得できるよう、さまざまなツールを実装しています。

利用可能な気象データツール

• 9日間天気予報（fnd）
• 現在の天気概況（rhrread）
• 地域天気予報（flw）
• 気象警報情報（warningInfo）
• 気象警報の概要（warnsum）
• 特別気象情報（swt）
• 簡易地震速報（qem）
• 震度を感じた地震の報告（feltearthquake）
• 潮汐情報（HHOT, HLT）
• 天文データ（SRS, lunardate）
• 雷および視程データ（LHL, LTMV）
• 気温記録（CLMTEMP, CLMMAXT, CLMMINT）
• 放射線レベル報告（RYES）
• 降雨データ（hourlyrainfall）

使用例

9日間天気予報を取得する

プロンプト：

来週の水曜日の天気は？

現在の天気概況を取得する

プロンプト：

今の天気は？

開発環境のセットアップ

1. 依存関係をインストールします：

npm install

2. MCP 開発サーバーを起動します：

npm run inspect

3. MCP サーバーをビルドします：

npm run build

4. テストを実行します：

npm test

5. ウォッチモードでテストを実行します：

npm run test:watch

すべての API 関数を対象とした包括的なテストを作成しています。詳細については、docs/TESTING.md を参照してください。

設定（Claude Desktop）

{
  "mcpServers": {
    "mcp-hko": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "github:louiscklaw/mcp-hko"
      ]
    }
  }
}

設定（docker）

{
  "mcpServers": {
    "mcp-hko-docker": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp-hko:latest"],
      "name": "mcp-hko (Docker)",
    }
  }
}

プロジェクト構成

• src/ - サーバーのソースコード
• src/lib/ - API 実装モジュール
• documentation/ - API ドキュメントとテストケース
• scripts/ - 開発用ユーティリティ
• src/tests/ - テストファイル

サーバーのアーキテクチャ

MCP サーバーは FastMCP フレームワークを基盤として構築されており、香港天文台の API に対応するさまざまなツールを実装しています。 見やすさを考慮し、アーキテクチャを2つの図で示しています。

サーバーの概要

ツール構成の詳細

REQ01xx：天気予報と警報

flowchart TD
    subgraph REQ01xx[Weather Forecasts & Warnings]
        direction BT
        B1[9-day Forecast]
        B2[Current Weather]
        B3[Local Forecast]
        B4[Warning Info]
        B5[Warning Summary]
        B6[Special Weather Tips]
    end

REQ02xx：地震情報

flowchart TD
    subgraph REQ02xx[Earthquake Information]
        C1[Quick Earthquake]
        C2[Felt Earthquake]
    end

REQ03xx：潮汐、天文、気候

flowchart TD
    subgraph REQ03xx[Tides, Astronomy & Climate]
        D1[Tide: HHOT]
        D2[Tide: HLT]
        D3[Sunrise/Sunset: SRS]
        D4[Lightning: LHL]
        D5[Visibility: LTMV]
        D6[Temperature: CLMTEMP]
        D7[Max Temperature: CLMMAXT]
        D8[Min Temperature: CLMMINT]
        D9[Radiation: RYES]
    end

REQ04xx：太陰暦

flowchart TD
    subgraph REQ04xx[Lunar Calendar]
        E1[Lunar Date]
    end

REQ05xx：降雨

flowchart TD
    subgraph REQ05xx[Rainfall]
        F1[Hourly Rainfall]
    end

クレジット：

• mcp-hk-transport-eta