# Weather MCP Server

Model Context Protocol (MCP) サーバーの実装プロジェクトです。天気情報を提供するツールを実装します。

## 参考ドキュメント

- [Building MCP Servers](https://modelcontextprotocol.io/docs/develop/build-server)
- [公式サンプルコード](https://github.com/modelcontextprotocol/quickstart-resources/tree/main/weather-server-python)

## システム要件

- Python 3.10以上
- uv (Pythonパッケージマネージャー)

## セットアップ

```bash
# 仮想環境の作成とアクティベート
uv venv
source .venv/bin/activate

# 依存関係のインストール
uv add "mcp[cli]" httpx
```

## 実行方法

```bash
uv run main.py
```

## 提供するツール

| ツール名 | 説明 |
|---------|------|
| `get_alerts` | 米国の州の気象警報を取得 |
| `get_forecast` | 緯度・経度から天気予報を取得 |

## Claude for Desktop への統合

`~/Library/Application Support/Claude/claude_desktop_config.json` を編集：

```json
{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/weather",
        "run",
        "main.py"
      ]
    }
  }
}
```

## 処理の流れ (What's happening under the hood)

Claude for Desktopでの質問から回答までの流れ：

```
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Claude Desktop │     │   MCP Server    │     │  External API   │
│    (Client)     │     │   (weather)     │     │  (weather.gov)  │
└────────┬────────┘     └────────┬────────┘     └────────┬────────┘
         │                       │                       │
         │  1. ユーザーが質問     │                       │
         │  「サクラメントの天気は？」                      │
         │                       │                       │
         │  2. Claudeが利用可能な │                       │
         │     ツールを分析       │                       │
         │                       │                       │
         │  3. ツール実行リクエスト│                       │
         │  (JSON-RPC over STDIO)│                       │
         │──────────────────────>│                       │
         │                       │  4. 外部API呼び出し    │
         │                       │──────────────────────>│
         │                       │                       │
         │                       │  5. APIレスポンス      │
         │                       │<──────────────────────│
         │  6. ツール実行結果     │                       │
         │<──────────────────────│                       │
         │                       │                       │
         │  7. Claudeが結果を解釈 │                       │
         │     して自然言語で回答 │                       │
         │                       │                       │
```

### ポイント

- **自動起動**: Claude Desktopが設定に基づいてMCPサーバープロセスを起動・管理
- **ツール検出**: クライアントがサーバーの `tools/list` を呼び出して利用可能なツールを取得
- **STDIO通信**: 標準入出力を介してJSON-RPCメッセージをやり取り
- **非同期実行**: API呼び出しなどのI/O操作を効率的に処理

## 注意事項

- STDIOベースのサーバーでは `print()` を使用しないこと（JSON-RPCメッセージが破損する）
- ログ出力には `logging` モジュールを使用する