JinDaGe - weather-api-mcp-server-f93 MCP Details

article

README

🚀 天气API MCP服务器

天气API MCP服务器是一个轻量级的模型上下文协议（MCP）服务器，可让AI助手（如Claude）获取并解释实时天气数据。

🚀 快速开始

环境准备

使用此项目前，请确保已安装Go语言。

克隆项目

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

安装依赖

go mod tidy

编译并运行服务器

go run internal/server/server.go

📦 安装指南

在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: 城市名称（字符串，必需）

🔧 技术细节

项目结构

该项目组织为以下几个关键目录：

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

weather-api-mcp-server-f93