met-mcp

met-mcp

一个用于获取挪威气象研究所（Yr）天气预报的 MCP 服务。作为学习项目构建。

提供三种使用方式：

• npm：met-mcp — 通过 stdio 在本地运行
• 远程：https://met-mcp.met-mcp-worker.workers.dev/mcp — 在 Cloudflare Workers 上通过 Streamable HTTP 提供，可将其添加为 claude.ai 连接器
• MCP 注册表：io.github.trondbjoroy/met-mcp

工具

• geocode_location(name, count) — 查找地点名称对应的坐标。使用免费的 Open-Meteo 地理编码器，因为 MET 没有地理编码 API。
• get_forecast(latitude, longitude, hours) — 来自 MET Locationforecast 2.0 的逐小时预报。全球可用，在北欧地区效果最佳。
• get_nowcast(latitude, longitude) — 未来 2 小时基于雷达的降水预报。仅限北欧地区。
• get_weather_alerts(latitude?, longitude?) — 挪威官方灾害预警（MetAlerts）。省略坐标即可获取整个挪威的预警。
• get_sun_events(latitude, longitude, date, utc_offset) — 日出、日落和太阳正午时间。全球可用。
• get_ocean_forecast(latitude, longitude, hours) — 挪威海岸沿线的浪高和海水温度。
• find_weather_stations(latitude, longitude, count) — 查找最近的官方气象站（Frost）。
• get_historical_weather(station_id, from, to, elements) — 来自 Frost 档案的每日历史观测数据；部分气象站的记录可追溯到 100 多年前。

这两个 Frost 工具需要免费的客户端 ID，可从 https://frost.met.no/auth/requestCredentials.html 获取，并将其设置为 FROST_CLIENT_ID 环境变量（或设置为 Cloudflare secret，供 worker 使用）。其他工具无需任何配置。

工具定义位于 src/tools.ts，由 stdio 服务和 worker 共用。

构建和测试

npm install
npm run build
npm test

测试会通过 stdio 启动服务，并调用两个工具访问实时 API。

与 Claude Code 配合使用

claude mcp add met-weather -- node C:\Users\trond\met-mcp\dist\index.js

然后向 Claude 提问：“明天卑尔根的天气怎么样？”

MET 服务条款

• 请发送包含联系信息的标识性 User-Agent。设置 MET_USER_AGENT 环境变量，例如 met-mcp/0.1.0 [email protected]。
• 坐标最多保留 4 位小数。服务会自动进行四舍五入。
• 数据许可：NLOD / CC BY 4.0。展示数据时请注明来源为 MET Norway。

远程版本

worker/ 中包含 Cloudflare Workers 部署：通过 MCP Streamable HTTP 和 createMcpHandler（MCP SDK v2）提供相同的两个工具。在 worker/ 中运行 npm run dev 进行开发，运行 npm run deploy 部署。

工作原理

• src/index.ts 是完整的服务。它通过 stdio 使用 MCP：在 stdin/stdout 上进行 JSON-RPC 通信。
• 每个工具都使用 Zod 声明输入架构。MCP 客户端（Claude）会读取架构并验证参数。
• 工具结果是 content 块。此服务会将 JSON 作为文本返回，并精简至大模型所需的内容；原始 MET 响应包含约 90 个时间步，以及多得多的字段。
• 切勿使用 console.log 写入 stdout，否则会破坏协议流。请将日志写入 stderr。