Weather Api MCP Server F93

🚀 天気API MCPサーバー

軽量なモデルコンテキストプロトコル（MCP）サーバーで、ClaudeなどのAIアシスタントがリアルタイムの天気データを取得して解釈できるようにします。

🚀 クイックスタート

このサーバーを使うことで、ClaudeなどのAIアシスタントが天気データを取得できます。以下に、さまざまな環境でのセットアップ方法を説明します。

📦 インストール

Claude Desktopでのインストール

MCPサーバーをClaude Desktopと一緒に使用するには、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"
    }
  }
}

ソースコードからのビルド

cmd/github-mcp-serverディレクトリでgoを使ってバイナリファイルをビルドできます。

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

Dockerコンテナの使用

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キーに置き換えてください。

💻 使用例

基本的な使用法

天気APIを使用するには、以下の手順を実行します。

1. 前提条件：Go言語がインストールされていることを確認します。
2. リポジトリのクローン：

git clone https://github.com/TuanKiri/weather-mcp-server.git
cd weather-mcp-server

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

go mod tidy

4. サーバーのコンパイルと実行：

go run internal/server/server.go

🔧 技術詳細

ツール

• current_weather - ある都市の現在の天気を取得します。
  • city: 都市名（文字列、必須）

プロジェクト構造

このプロジェクトは以下の主要なディレクトリに整理されています。

├── cmd
│   └── weather-mcp-server
├── internal
│   └── server
│       ├── handlers # MCPハンドラー
│       ├── services # ビジネスロジック層
│       │   ├── core # コアアプリケーションロジック
│       │   └── mock # テスト用のモックサービス
│       ├── tools # MCPツール
│       └── view # メッセージ表示用のテンプレート
└── pkg

テスト

新機能を追加した場合は、必ずテストを含めてください。

1. mockgenツールのインストール：

go get github.com/golang/mock/mockgen/cmd/...

2. プロジェクトのルートディレクトリで以下のコマンドを実行してモックファイルを生成します。

mockgen -source internal/server/handlers/weather.go -package mocks > internal/server/mocks/weather.go

🤝 貢献

貢献は大歓迎です！詳細は貢献ガイドをご覧ください。

📄 ライセンス

このプロジェクトはMIT Licenseの保護を受けています。