Weather MCP Server

Weather MCP Server

MCP Python SDK を使用して構築された、米国の州の気象警報を提供する Model Context Protocol（MCP）サーバーの実装です。このプロジェクトでは、ツール、リソース、Docker との連携を備えた MCP サーバーの作成方法を紹介します。

機能

• National Weather Service API を使用した、米国の州の気象警報
• stdio と SSE（Server-Sent Events）の両トランスポートに対応
• Docker によるコンテナ化
• Claude Desktop および Cursor IDE との連携
• Groq を使用した LLM 搭載のコマンドラインクライアント
• 会話メモリに標準対応

プロジェクト構成

Creating-MCP-server/
├── server/
│   ├── weather.py        # Main MCP server implementation
│   ├── client.py         # LLM-powered CLI client
│   └── weather.json      # Server configuration
├── mcpserver/
│   ├── Dockerfile        # Docker configuration
│   ├── requirements.txt  # Python dependencies
│   ├── client-stdio.py   # Standard I/O client example
│   ├── client-sse.py     # SSE client example
│   └── server.py         # Containerized server

インストール

ローカル環境のセットアップ

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

git clone <repository-url>
cd Creating-MCP-server

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

pip install -r mcpserver/requirements.txt

Docker のセットアップ

ビルド済みイメージを取得します：

docker pull ksharma9719/weather-mcp-server

または、ローカルでビルドします：

cd mcpserver
docker build -t weather-mcp-server .

使い方

サーバーの起動

ローカル開発

cd server
python weather.py

Docker を使用

docker run -p 8000:8000 ksharma9719/weather-mcp-server

クライアントの例

LLM 連携 CLI クライアント

cd server
python client.py

標準入出力クライアント

cd mcpserver
python client-stdio.py

SSE クライアント

cd mcpserver
python client-sse.py

利用可能なツール

get_alerts

米国の州の気象警報を取得します。

パラメーター：

• state：米国の州を示す2文字のコード（例：CA、TX、NY）

例：

result = await session.call_tool("get_alerts", arguments={"state": "CA"})

Claude Desktop との連携

1. サーバーを Claude Desktop にインストールします：

mcp install weather.py

2. 任意：カスタム名を指定します：

mcp install weather.py --name "Weather Alerts Server"

開発

前提条件

• Python 3.11 以降
• uv パッケージマネージャー
• Docker（任意）

環境変数

サーバーディレクトリに .env ファイルを作成します：

GROQ_API_KEY=your_groq_api_key

ドキュメント

• Model Context Protocol SDK のドキュメント
• MCP Use のドキュメント

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細については LICENSE ファイルをご覧ください。

謝辞

• 優れた SDK を提供してくださった Model Context Protocol チーム
• 公開 API を提供してくださった National Weather Service
• LLM API を提供してくださった Groq