MCP O7b

🚀 天気 MCP サーバー

このサーバーは FastMCP をベースに構築された天気情報照会サーバーで、世界中の都市の天気情報を提供します。

🚀 クイックスタート

1. リポジトリのクローン

git clone <repository-url>
cd weather-mcp-server

2. 依存関係のインストール

make install

3. 環境変数の設定

.env ファイルを作成し、以下の内容を追加します。

OPENWEATHER_API_KEY=あなたのOpenWeatherMap_APIキー

4. サーバーの起動

make run

✨ 主な機能

• 世界中の都市の天気照会に対応
• 温度、湿度、天気の説明情報を提供
• 摂氏と華氏の温度単位の切り替えに対応
• Model Context Protocol (MCP) をベースに実装
• 完全なログ記録

📦 インストール

インストール要件

• Python 3.8+
• OpenWeatherMap API キー
• uv (Python パッケージ管理ツール)

インストールと使用方法

オプション 1：uvx を使用する（推奨）

uvx を使用すると、リポジトリをクローンすることなく PyPI から自動的にパッケージをインストールできます。Claude Desktop の設定ファイル claude_desktop_config.json に以下の設定を追加します。

{
  "mcpServers": {
    "weather-mcp-server": {
      "command": "uvx",
      "args": [
        "weather-mcp-server"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "あなたのOpenWeatherMap_APIキー"
      }
    }
  }
}

オプション 2：ローカル開発モード

1. リポジトリをクローンし、依存関係をインストールします。

git clone <repository-url>
cd weather-mcp-server
make install

2. 環境変数を設定します。 .env ファイルを作成し、以下の内容を追加します。

OPENWEATHER_API_KEY=あなたのOpenWeatherMap_APIキー

3. Claude Desktop の設定ファイルに以下を追加します。

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/weather_mcp_server",
        "run",
        "weather-mcp-server"
      ],
      "env": {
        "OPENWEATHER_API_KEY": "あなたのOpenWeatherMap_APIキー"
      }
    }
  }
}

設定ファイルの場所：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

Claude Desktop を再起動して、新しい MCP サーバーを読み込みます。

🔧 開発

このプロジェクトでは、Makefile を使用して一般的なコマンドを簡素化しています。

利用可能なコマンド

make install  # 依存関係のインストール
make format   # コードのフォーマット
make lint     # コードチェックの実行
make clean    # 一時ファイルのクリーンアップ
make run      # サーバーの起動

新しいバージョンのリリース

make release version=v0.1.0

📚 ドキュメント

MCP ツール

サーバーは以下の MCP ツールを提供します。

get_weather

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

パラメーター：

• city: 都市名（必須）
• units: 温度単位（オプション、デフォルトは "metric"）
  • "metric": 摂氏
  • "imperial": 華氏

リクエスト例：

{
    "name": "get_weather",
    "kwargs": {
        "city": "Beijing",
        "units": "metric"
    }
}

レスポンス例：

{
    "temperature": 20.5,
    "humidity": 65,
    "description": "晴",
    "city": "Beijing"
}

これで、Claude を使用して自然言語で天気を照会できます。例えば：

• "北京の天気はどうですか？"
• "ニューヨークの現在の温度は何度ですか？"
• "大阪の天気を教えてください。"