# MCP-Weather

気象庁APIを使用した天気情報取得MCPサーバー（OAuth 2.0認証付き）

## 概要

mcp-weatherは、気象庁の天気予報API（livedoor 天気互換）を使用して、日本各地の天気情報を取得するMCPサーバーです。OAuth 2.0認証を使用したセキュアなアクセス制御により、Cloudflare Workersでリモートサーバーとしてデプロイ可能です。

## 特徴

- **OAuth 2.0認証**: セキュアなアクセス制御とトークンベース認証
- **豊富な気象データ**: 天気概況、降水確率、風速情報を提供
- **全国対応**: 主要都市の天気データを取得可能
- **リモート対応**: Cloudflare Workersにデプロイしてリモートサーバーとして利用可能
- **モバイル対応**: 標準的なOAuthフローでモバイルアプリからも利用可能

## 利用できるツール

### 1. get_weather_overview
指定した都市の天気概況を取得します。
- 発表時刻
- 天気概況文
- 今日・明日・明後日の天気予報
- 詳細な天気情報

### 2. get_precipitation_probability
指定した都市の降水確率を取得します。
- 時間帯別（0-6時、6-12時、12-18時、18-24時）の降水確率
- 今日・明日・明後日の予報

### 3. get_wind_speed
指定した都市の風速情報を取得します。
- 風向・風速の詳細情報
- 今日・明日・明後日の予報

## 対応都市

札幌、青森、盛岡、仙台、秋田、山形、福島、水戸、宇都宮、前橋、さいたま、千葉、東京、横浜、新潟、富山、金沢、福井、甲府、長野、岐阜、静岡、名古屋、津、大津、京都、大阪、神戸、奈良、和歌山、鳥取、松江、岡山、広島、山口、徳島、高松、松山、高知、福岡、佐賀、長崎、熊本、大分、宮崎、鹿児島、那覇

## セットアップ

### 利用方法の選択

このMCPサーバーは2つの利用方法をサポートしています：

| 利用方法 | 特徴 | 認証 | 設定の複雑さ |
|---------|------|------|-------------|
| **ローカルMCPサーバー** | 高速、プライバシー保護、信頼性 | 不要 | 簡単 |
| **リモートMCPサーバー** | 最新機能、スケーラビリティ | OAuth 2.0 | 中程度 |

### 方法A: ローカルMCPサーバー（推奨・簡単）

認証不要でシンプルに利用できます。

#### 1. 依存関係のインストール
```bash
npm install
```

#### 2. ローカルMCPサーバーをビルド
```bash
npm run build:local
```

#### 3. Cursorのmcp.jsonに設定
```json
{
  "mcp-weather-local": {
    "command": "node",
    "args": ["/path/to/MCP-Weather/dist/server/local/index.js"]
  }
}
```

#### 4. 使用開始
Cursorを再起動して、「東京の天気を教えて」と入力してください。

### 方法B: リモートMCPサーバー（OAuth認証）

#### 方法1: 自動トークン更新（推奨）
```bash
# プロジェクトディレクトリで実行
node src/utils/update-token.cjs
```

#### 方法2: 手動設定
1. **OAuth認証トークンの取得**
```bash
node src/utils/get-token.cjs
```

2. **トークンを手動で更新**
   - `src/client/mcp-weather-remote.cjs`の`ACCESS_TOKEN`を更新

3. **Cursorのmcp.jsonに設定**
```json
{
  "mcp-weather-remote": {
    "command": "node",
    "args": ["/path/to/MCP-Weather/src/client/mcp-weather-remote.cjs"]
  }
}
```

#### 環境変数を使用する場合
```bash
export MCP_WEATHER_TOKEN="your-token-here"
```

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

#### ローカルMCPサーバーの問題
1. **依存関係のインストール確認**
```bash
npm install
```

2. **TypeScriptの直接実行**
```bash
npm run dev:local
```

#### リモートMCPサーバーの問題
1. **デバッグ版を使用**
```json
{
  "mcp-weather-remote-debug": {
    "command": "node",
    "args": ["/path/to/MCP-Weather/src/client/mcp-weather-debug.cjs"]
  }
}
```

2. **トークンの期限切れ**
```bash
node src/utils/update-token.cjs
```

3. **Cursorのログを確認**
   - Cursor > View > Output > MCP

#### ファイル構成
```
MCP-Weather/
├── src/
│   ├── server/               # サーバーサイド実装
│   │   ├── local/            # ローカルサーバー
│   │   │   └── index.ts      # ローカルMCPサーバー
│   │   └── remote/           # リモートサーバー
│   │       ├── worker.ts     # Cloudflare Workers実装
│   │       └── auth.ts       # OAuth認証サービス
│   ├── client/               # クライアントサイド実装
│   │   ├── mcp-weather-remote.cjs  # メインのMCPクライアント
│   │   └── mcp-weather-debug.cjs   # デバッグ版
│   └── utils/                # ユーティリティ
│       ├── get-token.cjs     # トークン取得スクリプト
│       └── update-token.cjs  # トークン自動更新スクリプト
├── dist/                     # ビルド出力
│   └── server/
│       ├── local/            # ローカルサーバーのビルド出力
│       └── remote/           # リモートサーバーのビルド出力
├── node_modules/             # 依存関係
├── package.json              # プロジェクト設定
├── package-lock.json         # 依存関係のロック
├── tsconfig.json             # TypeScript設定（リモート用）
├── tsconfig.local.json       # TypeScript設定（ローカル用）
├── wrangler.toml             # Cloudflare Workers設定
└── README.md
```

### 開発者向けセットアップ

#### 依存関係のインストール

```bash
npm install
```

#### ローカルMCPサーバーの開発

```bash
# ローカルサーバーのビルド
npm run build:local

# ローカルサーバーの開発モード
npm run dev:local

# ローカルサーバーの型チェック
npm run type-check:local
```

#### Cloudflare Workersへのデプロイ

1. Wranglerのインストール（未インストールの場合）
```bash
npm install -g wrangler
```

2. Cloudflareアカウントへのログイン
```bash
npx wrangler login
```

3. KVストレージの作成
OAuth認証データを保存するためのKVネームスペースを作成します：

```bash
# 本番環境用
npx wrangler kv:namespace create "OAUTH_KV"
# 開発環境用
npx wrangler kv:namespace create "OAUTH_KV" --preview
```

4. `wrangler.toml`のKV IDを更新
作成したKVネームスペースのIDを`wrangler.toml`に設定してください。

5. デプロイ
```bash
# ビルド
npm run build

# デプロイ
npx wrangler deploy
```

#### ローカル開発

```bash
# 開発モードで起動
npx wrangler dev

# ビルド
npm run build
```

## 使用方法

### ローカルMCPサーバーでの利用

1. **設定完了後、Cursorを再起動**
2. **天気情報の取得**
   - Cursorで「東京の天気を教えて」と入力
   - 自動的に適切なツールが呼び出されます

### リモートMCPサーバーでの利用

1. **トークンの取得と設定**
```bash
node src/utils/update-token.cjs
```

2. **天気情報の取得**
   - Cursorで「東京の天気を教えて」と入力
   - 自動的に適切なツールが呼び出されます

### デモ認証情報（リモートMCPサーバー用）

開発・テスト用のデモ認証情報：
- **ユーザー名**: demo
- **パスワード**: demo123

※ローカルMCPサーバーを使用する場合は認証不要です。

## モバイルアプリ開発者向け

### OAuth 2.0 APIエンドポイント

- **クライアント作成**: `POST /oauth/client`
- **認証開始**: `GET /oauth/authorize`
- **トークン取得**: `POST /oauth/token`
- **MCP API**: `POST /` (Bearer認証)

### 対応プラットフォーム

- **iOS**: SFSafariViewController, ASWebAuthenticationSession
- **Android**: Chrome Custom Tabs, WebView
- **React Native**: react-native-app-auth
- **Flutter**: flutter_appauth

詳細な実装例は、プロジェクトのサーバー側コード（`src/`）を参照してください。

## データソース

本サーバーは「天気予報 API（livedoor 天気互換）」（https://weather.tsukumijima.net/）を使用しています。
このAPIは気象庁が配信している天気予報データをJSON形式で提供しています。

## セキュリティ

### OAuth 2.0認証

- **認証コード**: 10分間の有効期限
- **アクセストークン**: 1時間の有効期限
- **PKCE対応**: モバイルアプリでのセキュアな認証

### 本番環境での設定

本番環境では以下の点にご注意ください：

1. **クライアントシークレット**: 安全に管理し、公開しないでください
2. **リダイレクトURI**: 信頼できるドメインのみを設定してください
3. **アクセストークン**: 適切に保護し、HTTPSでのみ送信してください

## 注意事項

- APIのレスポンスが予期しないデータになった場合、エラーが発生する可能性があります
- 気象庁HPのAPI構造が変更された場合、サービスが停止する可能性があります
- 連続したAPIアクセスは避け、適切な間隔を空けてご利用ください
- OAuth認証のトークンは適切に管理し、第三者に漏洩しないよう注意してください