Weather API MCP Server

Claude などの AI アシスタントがリアルタイムの気象データを取得・解釈できるようにする、軽量な Model Context Protocol（MCP）サーバーです。

Claude Desktop へのインストール

Claude Desktop で MCP サーバーを使用するには、Claude の設定に追加します。

1. ローカルモード

{
  "mcpServers": {
    "weather-mcp-server": {
      "command": "/path/to/weather-mcp-server",
      "env": {
        "WEATHER_API_KEY": "your-api-key"
      }
    }
  }
}

API キーは、WeatherAPI の個人アカウントから取得できます。

2. リモートモード

{
  "mcpServers": {
    "weather-mcp-server": {
      "url": "http://host:port/sse"
    }
  }
}

ソースからビルドする

go を使用して、cmd/github-mcp-server ディレクトリにあるバイナリをビルドできます。

go build -o weather-mcp-server ./cmd/weather-mcp-server

Docker コンテナで MCP を使用する

1. Docker イメージをビルドする：

docker build -t weather-mcp-server .

2. Docker コンテナを実行する：

docker run -e WEATHER_API_KEY=your-api-key -d --name weather-mcp-server -p 8000:8000 weather-mcp-server

your-api-key を実際の WeatherAPI API キーに置き換えてください。

ツール

• current_weather - 都市の現在の天気を取得します

  • city：都市名（文字列、必須）

プロジェクト構成

プロジェクトはいくつかの主要なディレクトリで構成されています。

├── cmd
│   └── weather-mcp-server
├── internal
│   └── server
│       ├── handlers # MCP handlers
│       ├── services # Business logic layer
│       │   ├── core # Core application logic
│       │   └── mock # Mock services for testing
│       ├── tools # MCP tools
│       └── view # Templates for displaying messages
└── pkg

テスト

新機能を追加する場合は、その機能のテストも必ず追加してください。

1. mockgen ツールをインストールする：

go install go.uber.org/mock/mockgen@latest

go.uber.org/mock のインストールガイドを参照してください。

2. 次のコマンドを使用してモックファイルを生成する：

make generate-mocks

3. 単体テストを実行する：

make run-tests

コントリビューション

改善に関するチケットの作成やプルリクエストの送信を歓迎します。ご協力に感謝します！

コントリビューションガイドラインに従ってください。

ライセンス

この MCP サーバーは、MIT ライセンスの下でライセンスされています。