Akaramanapp Weather MCP Server

🚀 天気 MCP サーバー

このサーバーは、米国地域の天気情報と警報を提供するモデルコンテキストプロトコル（MCP）サーバーです。国家気象局（NWS）のAPIを使用しており、AIエージェントがモデルコンテキストプロトコルを通じて利用するために設計されています。

✨ 主な機能

• 特定の米国州の天気警報を取得するツール
• 座標を使用して任意の地理位置の詳細な天気予報を取得するツール
• 温度、風力条件、簡単な天気説明をサポート
• 国家気象局からのリアルタイムデータ

📦 インストール

前提条件

• Node.js（v16 以上）
• npm または yarn パッケージマネージャー

インストール手順

1. リポジトリをクローンします：

git clone https://github.com/akaramanapp/weather-mcp-server.git
cd weather-mcp-server

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

npm install

3. アプリケーションをビルドします：

npm run build

💻 使用例

MCP ツール

このサーバーは、AIエージェントが使用するための2つのMCPツールを提供しています。

get-alerts

特定の米国州の天気警報を取得します。

パラメータ：

• state：2文字の州コード（例：CA、NY）

応答例：

{
  "content": [
    {
      "type": "text",
      "text": "CA 州のアクティブな警報：..."
    }
  ]
}

get-forecast

座標を使用して特定の位置の天気予報を取得します。

パラメータ：

• latitude：位置の緯度（-90 から 90）
• longitude：位置の経度（-180 から 180）

応答例：

{
  "content": [
    {
      "type": "text",
      "text": "朝：温度：72°F、風速：5mph NW、曇り..."
    }
  ]
}

📚 ドキュメント

プロジェクト構造

weather/
├── src/
│   └── index.ts    # メインサーバーコード、MCPツールの実装を含む
├── build/          # コンパイル後の JavaScript ファイル
├── package.json    # プロジェクトの依存関係とスクリプト
└── tsconfig.json   # TypeScript の設定

開発

サーバーを変更または拡張するには、以下の手順を行います。

1. src/index.ts ファイルを変更します。
2. アプリケーションを再ビルドします：

npm run build

依存関係

• @modelcontextprotocol/sdk：MCPサーバーの実装フレームワーク
• zod：ツールのパラメータのランタイム型チェックと検証
• TypeScript：型安全な開発のための依存関係

🔧 技術詳細

• TypeScript で開発されています。
• モデルコンテキストプロトコル（MCP）サーバーを実装しています。
• @modelcontextprotocol/sdk を使用してMCPサーバーを実装しています。
• 国家気象局（NWS）のAPIとインターフェースを介して通信しています。
• ターゲットは ES2022 で、Node16 のモジュール解決を使用しています。

📄 ライセンス

ISC

注意事項

⚠️ 重要提示

このサーバーは国家気象局のAPIを使用しているため、米国地域のみを対象としています。APIリクエストにはレート制限があり、User-Agentヘッダーが必要です。すべての座標は十進制度数形式で指定する必要があります。これは独立したCLIアプリケーションではなく、モデルコンテキストプロトコルを通じてAIエージェントにツールを提供するサーバーです。