Weather MCP Server

Weather MCP Server

一个 MCP（Model Context Protocol）服务，可通过加拿大政府天气 API 提供天气预报数据。

功能

• 提供纬度和经度，即可获取加拿大任意地点的天气预报
• 可轻松集成到 Claude Desktop 或任何兼容 MCP 的客户端中

安装

先决条件

• Python 3.13 或更高版本
• mise 或其他 Python 版本管理器（可选）

安装步骤

1. 克隆此仓库：

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

2. 创建虚拟环境（可选，但建议创建）：

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 安装软件包及依赖项：

   pip install -e .
   

使用方法

作为独立服务运行

直接运行服务：

python weather.py

与 Claude Desktop 集成

与 Claude Desktop 集成：

1. 编辑 Claude Desktop 配置文件（在 macOS 上通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "weather": {
      "command": "/path/to/python", 
      "args": [
        "/path/to/weather-mcp/weather.py"
      ]
    }
  }
}

2. 重启 Claude Desktop 以应用更改

与其他 MCP 宿主搭配使用

要与其他 MCP 宿主搭配使用，请将宿主配置为使用 Python 3.13 或更高版本执行 weather.py。

API 参考

get_forecast(latitude: float, longitude: float) -> str

获取指定地点未来 5 天的天气预报。

参数：

• latitude：地点的纬度
• longitude：地点的经度

返回值：

• 包含未来 5 天天气预报的格式化字符串

在 Claude 中的使用示例：

Please get the weather forecast for Ottawa, Canada (45.4215, -75.6972)

开发

运行测试

pytest

参与贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目依据仓库中包含的许可证条款授权。