MCP Weather Xqw

🚀 MCP-weather

これは、AIエージェントが使用するMCPサーバーのサンプルで、米国各州の天気予報と警報情報を取得することができます。

• オリジナルプロジェクト: mcp-sse

🚀 クイックスタート

このmcpサーバーは、SSEベースのMCPサーバーと、そのツールを使用する独立したMCPクライアントの動作モードを示しています。

📦 インストール

運行環境

このプロジェクトでは、uv を使用して関連する依存関係とPythonの実行環境を管理しています。uvがまだインストールされていない場合は、公式サイトのインストール手順に従ってインストールしてください。

以下のコマンドは、Ubuntu 24.04環境で実行されます。他のオペレーティングシステムでは、適宜変更してください。

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

ソースコードをダウンロードします。

$ git clone https://github.com/erhwenkuo/mcp-weather.git

$ cd mcp-weather

$ uv sync

運行服務

使用 uv 來啟動

$ uv run server

INFO:     Started server process [15784]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8080 (Press CTRL+C to quit)

使用 Docker 來啟動

まず、Dockerイメージを構築します。

$ docker build -t mcp-weather .

mcp-weatherを起動します。

$ docker run -d -p 5488:5488 mcp-weather

💻 使用例

驚證結果

まず、Node.jsをインストールします。

# 下載並安裝 nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash

# 代入 shell 環境變量
\. "$HOME/.nvm/nvm.sh"

# 安裝 Node.js:
nvm install 22

# 驗證 Node.js 版本:
node -v # 應該輸出 "v22.14.0".
nvm current # 應該輸出 "v22.14.0".

# 驗證 npm 版本:
npm -v # 應該輸出 "10.9.2".

次に、mcp inspector を起動します。

$ npx @modelcontextprotocol/inspector

Starting MCP inspector...
Proxy server listening on port 3000

ブラウザを開き、http://localhost:3000 にアクセスし、指示に従ってmcp-weatherサーバーをテストします。

🔧 技術詳細

為什麼選擇 SSE

このプロジェクトでは、SSE（Streaming Strategy Engine）を通信プロトコルとして使用しています。理由は以下の通りです。

1. 長時間接続をサポートしており、リアルタイムデータの送信に適しています。
2. 送信側と受信側を分離できるため、システムの拡張性が向上します。
3. クラウドネイティブ環境での使用に適しています。

SSEサーバーは、デフォルトで localhost:5488 で実行されますが、コマンドライン引数で構成することができます。

uv run server.py --host <your host> --port <your port>