Weather MCP 服务器

一个简单的 MCP (模型控制协议) 服务器，使用美国国家气象局 API 提供天气信息。此服务器公开两个工具：

• get_alerts: 获取美国州的天气警报
• get_forecast: 获取特定位置的天气预报

前提条件

• Python 3.10 或更高版本
• uv 包管理器 (推荐) 或 pip

安装

1. 克隆此仓库：

git clone <your-repo-url>
cd simple_mcp_server

2. 设置您的 Python 环境：

使用 uv (推荐):

# 如果您还没有安装 uv，请安装它
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # 在 Windows 上使用: .venv\Scripts\activate

# 安装依赖
uv add "mcp[cli]" httpx

或者使用 pip:

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用: .venv\Scripts\activate
pip install "mcp[cli]" httpx

用法

1. 运行服务器：

mcp dev main.py

2. 配置 Claude for Desktop:

   • 在 ~/Library/Application Support/Claude/claude_desktop_config.json 打开您的 Claude for Desktop App 配置
   • 添加以下配置：

   {
     "mcpServers": {
       "weather": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/simple_mcp_server",
           "run",
           "main.py"
         ]
       }
     }
   }
   

   • 将 /ABSOLUTE/PATH/TO/simple_mcp_server 替换为您项目目录的实际路径
   • 保存文件并重启 Claude for Desktop

3. 测试服务器：

   • 打开 Claude for Desktop
   • 在界面中寻找锤子图标
   • 您应该看到列出了两个工具：get_alerts 和 get_forecast
   • 尝试提出如下问题：
     • "What's the weather in NY?" (纽约的天气怎么样？)
     • "What are the active weather alerts in NY?" (纽约有哪些活跃的天气警报？)

可用工具

get_alerts

获取美国州的天气警报。

参数：

• state (str): 两位数的美国州代码 (例如，'CA', 'NY')

get_forecast

获取特定位置的天气预报。

参数：

• latitude (float): 位置的纬度
• longitude (float): 位置的经度

故障排除

1. 如果 Claude for Desktop 没有检测到服务器：

   • 确保配置文件路径正确
   • 验证配置中的绝对路径是否正确
   • 确保已安装所有依赖项
   • 尝试重启 Claude for Desktop

2. 如果您收到天气 API 错误：

   • 检查您的互联网连接
   • 验证坐标或州代码是否有效
   • 美国国家气象局 API 仅适用于美国地区