Weather MCP Server

Weather MCP Server

中国語ドキュメント | 英語

Model Context Protocol（MCP）で構築されたシンプルな天気情報サービスです。

概要

Weather MCP Server は、シンプルな API インターフェースを通じて世界中の都市の天気情報を提供します。Model Context Protocol（MCP）を使用してクライアントと通信するため、AI アシスタントやその他の MCP 対応アプリケーションと簡単に統合できます。

機能

• 都市名から現在の天気を取得
• 気温、天気の説明、湿度、風速を返します
• 外部 API が利用できない場合は、生成されたデータを使用します
• シンプルで軽量な実装です

技術スタック

• TypeScript
• Node.js
• MCP SDK (@modelcontextprotocol/sdk)
• バリデーション用の Zod

インストール

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

git clone https://github.com/Annihilater/mcp-server-get-weather

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

npm install

3. プロジェクトをビルドします：

npm run build

使用方法

サーバーを起動します：

npx @modelcontextprotocol/inspector node dist/index.js

MCP の設定

Cursorでこの天気サービスを使用するには、~/.cursor/mcp.jsonファイルに次の設定を追加します：

"mcp-server-get-weather": {
  "command": "node",
  "args": [
    "<path-to-your-project>/dist/index.js"
  ]
}

<path-to-your-project>を実際のプロジェクトパスに置き換えます。設定が完了すると、MCP ツールからmcp_mcp_server_get_weather_get_weather関数を呼び出して、天気情報を取得できます。

例

API リファレンス

get_weather

指定した都市の天気情報を取得します。

パラメーター

名前	型	説明
cityName	string	天気情報を取得する都市の名前

レスポンス

次の構造の JSON オブジェクトを返します：

{
  "city": "London",
  "current_condition": {
    "temperature": "15",
    "weatherDesc": "Partly cloudy",
    "humidity": "71",
    "windSpeed": "11",
    "observation_time": "06:53 PM"
  },
  "forecast": {
    "maxTemp": "16",
    "minTemp": "9",
    "sunHour": "7.4",
    "date": "2023-04-12"
  }
}

開発

使用可能なスクリプト

• npm run build - プロジェクトをビルドし、エントリーポイントを実行可能にします
• npm run watch - 変更を監視し、自動的に再ビルドします
• npx @modelcontextprotocol/inspector node dist/index.js - サーバーを起動します

プロジェクト構成

• src/index.ts - エントリーポイント。stdio トランスポートを使用して MCP サーバーを設定します
• src/server.ts - サーバーの実装。天気ツールを定義します

ライセンス

MIT