Weather Api MCP Server F93

🚀 天氣API MCP服務器

一個輕量級的模型上下文協議（MCP）服務器，使AI助手如Claude能夠獲取和解釋即時天氣數據。

🚀 快速開始

本服務器可助力AI助手Claude獲取並解讀即時天氣數據。以下為你介紹不同場景下的使用方法。

📦 安裝指南

在Claude Desktop上安裝

要將您的MCP服務器與Claude Desktop一起使用，請將其添加到Claude配置中：

1. 本地模式

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

您可以從WeatherAPI獲取一個API密鑰。

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密鑰。

💻 使用示例

工具

• current_weather - 獲取某個城市的當前天氣
  • city: 城市名稱（字符串，必需）

使用步驟

要使用天氣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

🔧 技術細節

項目結構

該項目組織為以下幾個關鍵目錄：

├── 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的保護。