weather-mcp-server

🌦 WeatherTrax MCP 服务

为 Claude 和其他 MCP 客户端提供快速、可靠的天气数据。
查询全球任意地点的当前天气状况和多日预报。

🌐 远程 MCP 服务（无需安装）
https://mcp-weathertrax.jaredco.com/mcp

---

---

⚡ 10 秒演示

向 Claude 提问：

“明天迈阿密的天气怎么样？”

Claude 将调用 MCP 天气服务，并立即返回天气预报。

API 调用示例：

curl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \
  -H "Content-Type: application/json" \
  -d '{"location":"Miami","query_type":"current"}'

---

🚀 功能

• 实时天气数据 – 当前天气状况、温度、湿度、风速
• 多日预报 – 最长 14 天的预报
• 规划工具 – 针对活动或施工优化的 7 天预报
• 灵活的位置输入 – 城市名称、邮政编码或坐标
• 节省令牌 – 针对大模型使用优化的精简响应
• 可用于生产环境 – 具备速率限制和监控功能
• 公共 API – 无需 API 密钥
• 符合 MCP 规范 – 完整支持 JSON-RPC 2.0

---

⚡ 快速开始

Claude

在 Claude 或 Claude Desktop 中，打开 设置 → 连接器 → 添加连接器，并使用：

Name: WeatherTrax
URL:  https://mcp-weathertrax.jaredco.com/mcp

现在你可以提问：

What’s the weather in New York this weekend?

---

🌐 直接使用 API

健康检查

curl https://mcp-weathertrax.jaredco.com/healthz

MCP 清单

curl https://mcp-weathertrax.jaredco.com/.well-known/mcp/manifest

---

💡 使用示例

当前天气

curl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \
  -H "Content-Type: application/json" \
  -d '{
    "location": "San Francisco, CA",
    "query_type": "current"
  }'

响应示例：

{
  "summary": "It is currently 54°F and Clear in San Francisco.",
  "temp_high": 54,
  "temp_low": 54,
  "condition": "Clear",
  "wind": "5 mph W",
  "humidity": 65
}

---

多日预报

curl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \
  -H "Content-Type: application/json" \
  -d '{
    "location": "New York",
    "query_type": "multi_day",
    "num_days": 3
  }'

---

🛠 可用工具

weatherTool

获取当前天气或天气预报。

输入：

{
  "location": "city name or coordinates",
  "query_type": "current | multi_day",
  "num_days": "optional forecast length"
}

---

weatherPlanningTool

针对户外作业或活动的 7 天规划预报。

输入：

{
  "location": "city or place",
  "context": "construction | travel | event",
  "timeframe": "optional timeframe hint"
}

---

🔗 MCP 协议集成

此服务支持完整的 MCP JSON-RPC 协议。

工具调用示例：

curl -X POST https://mcp-weathertrax.jaredco.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"tools/call",
    "params":{
      "name":"weatherTool",
      "arguments":{
        "location":"London",
        "query_type":"current"
      }
    }
  }'

---

🧪 测试

在一个终端中本地运行：

npm install
npm start

在另一个终端中运行协议测试：

npm test

发布冒烟测试套件：

npm run test:full

npm run test:full 目前运行相同的受支持端到端冒烟测试套件。旧版 Streamable HTTP 之前的回归测试框架仍可通过 npm run test:legacy 使用；保留该框架仅供参考，不作为发布门槛。

部署配置

设置以下服务端环境变量；切勿将其提交到版本库：

变量	必需	用途
WEATHER_API_KEY	是	World Weather Online API 密钥。
PORT	否	HTTP 监听端口；默认为 3000。
TRUST_PROXY	视生产环境而定	受信任的反向代理跳数；如果使用单个已知代理，请设为 1。
ALLOWED_ORIGINS	否	允许调用 MCP 的浏览器来源列表，以逗号分隔；默认为 https://claude.ai。

该服务在 /metrics 提供汇总且不含身份信息的运行指标。若未添加适当的访问控制，请勿将此端点置于公共仪表板之后。

---

🔒 隐私

隐私政策：

https://mcp-weathertrax.jaredco.com/privacy

要点：

• 仅收集汇总运行指标；不记录位置和提供方原始响应
• 短期内存缓存可减少重复的提供方请求
• 不使用 Cookie 或跟踪技术
• 强制使用 HTTPS

---

🛠 开发

克隆仓库：

git clone https://github.com/jaredco/weather-mcp-server.git
cd weather-mcp-server
npm install
npm start

服务在本地运行于：

http://localhost:3000

---

📦 技术栈

• Node.js
• Express 5
• @modelcontextprotocol/sdk
• World Weather Online API
• Railway 托管

---

📄 许可证

MIT 许可证。

---

🌟 致谢

使用 Anthropic 开发的 Model Context Protocol 构建。

天气数据由 World Weather Online 提供。

---

📊 状态

服务：生产环境
API 版本：1.0.1
MCP 协议：2025-03-26

---

为 Claude 和 MCP 倾情打造 ☀️