Weather MCP Ts

🚀 天気MCPサーバー

TypeScriptで開発された天気MCP（Model Context Protocol）サーバーで、シミュレートされた天気データと関連機能を提供します。

✨ 主な機能

• 🌤️ 現在の天気情報を取得
• 📅 複数日間の天気予報
• ⚠️ 天気警報システム
• 🔍 場所検索機能
• 📊 天気統計
• 🎭 モックデータのサポート

📦 インストール

pnpm install

🚀 クイックスタート

インストールとビルド

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

# プロジェクトのビルド
pnpm run build

起動方法

1. MCPプロトコル (stdio)

# MCPクライアントとの統合用
pnpm start

2. HTTP APIサーバー 🆕

# HTTPサーバーの起動 (デフォルトポート8080)
pnpm run start:http

# HTTPサーバーの起動 (指定ポート3001)
pnpm run start:http:3001

# または直接ポートを指定する
node dist/http-server.js 8080

3. シンプルなHTTPサーバー (推奨) 🚀

# デフォルトポート8080で起動
pnpm run start:simple

# 特定のポートで起動
pnpm run start:simple:3000  # 開発用ポート
pnpm run start:simple:5000  # 代替ポート
pnpm run start:simple:9000  # 高ポート

# またはserveコマンドを使用する
pnpm run serve              # デフォルトポート8080
pnpm run serve:dev          # 開発用ポート3000
pnpm run serve:prod         # 本番用ポート8080

# または任意のポートを直接指定する
node dist/simple-http-server.js 4000

動的ポートサポート

シンプルなHTTPサーバーは動的なポート構成をサポートしています：

# 任意のポートを使用する
node dist/simple-http-server.js 3000
node dist/simple-http-server.js 5000
node dist/simple-http-server.js 9000
node dist/simple-http-server.js 12345

サーバーは自動的に以下のことを行います：

• ポートが指定されない場合はデフォルトでポート8080を使用します
• 有効なポート番号をコマンドライン引数として受け付けます
• 起動メッセージとドキュメントに実際のポートを表示します

💻 使用例

HTTP APIの使用例

HTTPサーバーを起動したら、以下のように使用できます：

ブラウザアクセス

• http://localhost:8080 を開いてAPIドキュメントを表示
• リンクを直接クリックして各種APIをテスト

curlコマンド

# 香港の現在の天気を取得
curl "http://localhost:8080/weather?location=Hong Kong"

# 東京の5日間の天気予報を取得
curl "http://localhost:8080/forecast?location=Tokyo&days=5"

# 天気警報を取得
curl "http://localhost:8080/alerts?location=Hong Kong"

# 場所を検索
curl "http://localhost:8080/locations?q=kong"

# 統計情報を取得
curl "http://localhost:8080/stats"

JavaScript/Fetch

// 天気データを取得
const response = await fetch('http://localhost:8080/weather?location=Tokyo');
const weather = await response.json();
console.log(weather);

開発モード

# ウォッチモードでコンパイル
pnpm run dev

利用可能なツール

1. get_current_weather

指定された場所の現在の天気情報を取得します。

パラメーター:

• location (文字列): 場所の名前

例:

{
  "location": "Hong Kong"
}

2. get_weather_forecast

指定された場所の天気予報を取得します。

パラメーター:

• location (文字列): 場所の名前
• days (数値, オプション): 予報日数 (1 - 7日, デフォルト3日)

例:

{
  "location": "Tokyo",
  "days": 5
}

3. get_weather_alerts

天気警報情報を取得します。

パラメーター:

• location (文字列, オプション): 場所の名前

例:

{
  "location": "Hong Kong"
}

4. search_locations

サポートされている場所を検索します。

パラメーター:

• query (文字列): 検索キーワード

例:

{
  "query": "kong"
}

5. get_weather_stats

天気統計情報を取得します。

パラメーター: なし

サポートされている場所

現在、以下の場所の詳細な天気データをサポートしています：

• 香港
• 東京、大阪、京都、広島、札幌、福岡（日本）
• ロンドン（英国）
• ニューヨーク（米国）
• シドニー（オーストラリア）

その他の場所はランダムに生成されたモックデータを返します。

🔧 技術詳細

• 言語: TypeScript
• パッケージマネージャー: pnpm
• MCP SDK: @modelcontextprotocol/sdk
• Node.js: >=18

プロジェクト構造

src/
├── index.ts              # MCPサーバーのメインファイル (stdio)
├── http-server.ts        # HTTP APIサーバー
├── simple-http-server.ts # シンプルなHTTPサーバー
├── weather-service.ts    # 天気サービスのロジック
├── mock-data.ts          # モックデータ
└── types.ts              # TypeScriptの型定義

HTTP APIエンドポイント

📄 ライセンス

MITライセンス