Weather MCP Server

Weather MCP Server

一个简单的 MCP（模型控制协议）服务，使用 National Weather Service API 提供天气信息。此服务提供两个工具：

• get_alerts：获取美国某个州的天气预警
• get_forecast：获取特定地点的天气预报

先决条件

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

安装

1. 克隆此仓库：

git clone <your-repo-url>
cd simple_mcp_server

2. 设置 Python 环境：

使用 uv（推荐）：

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

# Install dependencies
uv add "mcp[cli]" httpx

或使用 pip：

python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
pip install "mcp[cli]" httpx

使用方法

1. 运行服务：

mcp dev main.py

2. 配置 Claude for Desktop：

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

   {
     "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
   • 尝试询问以下问题：
     • “纽约的天气怎么样？”
     • “纽约目前有哪些天气预警？”

可用工具

get_alerts

获取美国某个州的天气预警。

参数：

• state（str）：美国州的两字母代码（例如，'CA'、'NY'）

get_forecast

获取特定地点的天气预报。

参数：

• latitude（float）：该地点的纬度
• longitude（float）：该地点的经度

故障排除

1. 如果 Claude for Desktop 未能检测到该服务：

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

2. 如果遇到天气 API 错误：

   • 检查网络连接
   • 确认坐标或州代码有效
   • National Weather Service API 仅适用于美国境内的位置