Weather MCP Server Lbv

🚀 天気 MCP サーバー

このサーバーは、天気情報を提供するモデルコンテキストプロトコル（MCP）サーバーで、デスクトップ版のClaudeに統合されています。国家気象局APIを通じて、米国内の任意の場所に対して天気予報と警報サービスを提供します。MIT MCPハッカソンイベント（2025年4月）の一環として作成されました。

✨ 主な機能

• get_forecast：緯度と経度を使用して、米国内の任意の場所の詳細な天気予報を取得します。
• get_alerts：州コードに基づいて、特定の州内のアクティブな天気警報を検索します。

📦 インストール

構成要件

• Python 3.10 以上
• uv パッケージマネージャー
• デスクトップ版 Claude
• MCP SDK 1.2.0 以上

インストール手順

1. uv がインストールされていることを確認します：

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Python環境を構成します：

# 仮想環境を作成してアクティブ化します
uv venv
source .venv/bin/activate

# 依存関係をインストールします
uv add "mcp[cli]" httpx

📚 設定手順

1. デスクトップ版Claudeの設定ファイル ~/Library/Application Support/Claude/claude_desktop_config.json を作成または編集します：

{
  "mcpServers": {
    "weather": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/weather",
        "run",
        "weather.py"
      ]
    }
  }
}

2. /path/to/uv を実際のuv実行可能ファイルのパスに置き換えます（which uv を使用して検索）
3. /absolute/path/to/weather をこのプロジェクトの絶対パスに置き換えます

💻 使用例

基本的な使用法

1. デスクトップ版Claudeを起動します。
2. ハンマー 🔨 アイコンを確認して、サーバーが接続されていることを確認します。
3. サンプルクエリ：
   • "サクラメントの天気はどうですか？"
   • "テキサス州にはどのようなアクティブな天気警報がありますか？"

🔧 トラブルシューティング

• Claudeのログファイル ~/Library/Logs/Claude/mcp*.log を確認します。
• 設定内のすべてのパスが絶対パスであることを確認します。
• サーバーが独立して実行できることを検証します（uv run weather.py を使用）。
• ポート8001が他のプロセスによって占有されていないことを確認します。

📚 APIドキュメント

このサーバーは国家気象局APIを使用しています：

• 基本URL：https://api.weather.gov
• 使用されるエンドポイント：
  • /alerts/active/area/{state} - 州に基づいて警報情報を取得します。
  • /points/{lat},{lon} - 予測グリッドデータを取得します。
  • /forecast - 詳細な予報を取得します。

🔖 MIT MCPハッカソンについて

このプロジェクトは、MIT MCPハッカソン（2025年4月）のチュートリアルの一部として作成されました。このハッカソンは、開発者にモデルコンテキストプロトコルを紹介し、プロジェクトやスタートアップが独自のMCPサーバーを起動するのを支援することを目的としています。このハッカソンは、MITナンダ（NANDA、ネットワーク化エージェントと分散型人工知能）ハブプロジェクトの一部です。

📄 ライセンス

このプロジェクトは、元のチュートリアルのライセンス声明に従います：モデルコンテキストプロトコル