使用说明

项目简介

本项目 'weather-mcp-server' 是一个实现了 Model Context Protocol (MCP) 的服务器，专注于提供天气信息服务。它通过定义和注册 'current_weather' 工具，使得支持 MCP 协议的AI助手（如 Claude）能够查询并获取指定城市的实时天气数据。服务器会将天气信息处理成 HTML 和 CSS 代码，方便 AI 助手直接渲染展示。

主要功能点

提供实时天气数据： 通过 'current_weather' 工具，根据城市名称查询实时的天气信息。
HTML格式化输出： 返回的天气信息被渲染为 HTML 和 CSS 代码，可以直接在支持 HTML 渲染的环境中展示，例如 Claude 的画布。
易于集成： 遵循 MCP 协议，可以方便地与支持 MCP 协议的客户端（如 Claude Desktop）集成。

安装步骤

安装 Go 语言环境： 确保你的机器上已经安装了 Go 语言环境（版本要求请参考仓库的 'go.mod' 文件）。

克隆仓库： 将 GitHub 仓库 'https://github.com/TuanKiri/weather-mcp-server' 克隆到本地。

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

构建可执行文件： 使用 'go build' 命令编译项目，生成可执行文件 'weather-mcp-server'。
```
go build -o weather-mcp-server ./cmd/weather-mcp-server
```
编译成功后，会在当前目录下生成 'weather-mcp-server' 可执行文件。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），你需要提供服务器的启动命令和相关参数。以下是一个 Claude Desktop 的 'mcpServers' 配置示例，你需要根据实际情况进行调整：

{
  "mcpServers": {
    "weather-mcp-server": {
      "command": "/path/to/weather-mcp-server",  // 替换为 weather-mcp-server 可执行文件的实际路径
      "args": [],                               // 启动参数，本项目无需额外参数
      "env": {
        "WEATHER_API_KEY": "YOUR_WEATHER_API_KEY" // 替换为你在 weatherapi.com 申请的 API 密钥
      }
    }
  }
}

配置说明：

'"weather-mcp-server"': 服务器名称，可以自定义，用于在客户端中标识和引用。
'"command"': 必须修改。指向 'weather-mcp-server' 可执行文件的绝对路径。例如，如果 'weather-mcp-server' 文件位于 '/home/user/weather-mcp-server'，则应设置为 '"/home/user/weather-mcp-server"'。
'"args"': 启动参数，本项目不需要额外的启动参数，保持为空数组 '[]' 即可。
'"env"': 环境变量配置。
- '"WEATHER_API_KEY"': 必须修改。你需要访问 weatherapi 网站，注册账号并获取 API 密钥。将 'YOUR_WEATHER_API_KEY' 替换为你获得的实际 API 密钥。请务必设置此环境变量，否则服务器无法正常获取天气数据。

基本使用方法

配置完成后，在支持 MCP 协议的客户端中（例如 Claude），你可以通过自然语言指令来调用 'current_weather' 工具，查询天气信息。例如，你可以对 Claude 说：

What's the weather in London?

或者

Current weather in Tokyo please.

客户端会将你的指令转换为 MCP 请求发送给 'weather-mcp-server'，服务器会调用 'current_weather' 工具获取伦敦或东京的当前天气，并将包含天气信息的 HTML 代码返回给客户端。客户端会解析 HTML 代码并将其渲染展示给你。

注意： 'current_weather' 工具只接受城市名称作为参数，且必须是英文城市名。

关键词