M

MCP天气

MCP天气

weather-servicesother

3.8k 查看 · 2026-07-07 更新

简介

MCP天气

简介

MCP天气

MCP 天气服务器

npm version license node version issues

MCP 天气服务器 Logo

这是一个使用 AccuWeather API 提供每小时天气预报的 Model Context Protocol (MCP) 服务器。


快速开始

你需要一个 AccuWeather API 密钥(免费层级可用)。
在此注册 并创建一个应用以获取你的密钥。

将你的 API 密钥导出为环境变量:

bash export ACCUWEATHER_API_KEY=your_api_key_here

然后直接运行 MCP 天气服务器:

bash npx -y @timlukahorstmann/mcp-weather

或者,通过 supergateway 进行 HTTP/REST 访问:

bash npx -y supergateway --stdio "npx -y @timlukahorstmann/mcp-weather" --port 4004 --baseUrl http://127.0.0.1:4004 --ssePath /messages --messagePath /message --cors "*" --env ACCUWEATHER_API_KEY="$ACCUWEATHER_API_KEY"


MCP 服务器配置示例

为了与 Claude Desktop 或其他兼容 MCP 的客户端集成,请在你的配置文件中添加以下内容(例如 claude_desktop_config.json):

json { "mcpServers": { "weather": { "command": "npx", "args": ["-y", "@timlukahorstmann/mcp-weather"], "env": { "ACCUWEATHER_API_KEY": "your_api_key_here" } } } }


概述

此 MCP 服务器允许大型语言模型(如 Claude)访问实时天气数据。当与 LLM 集成时,它使模型能够:

  • 获取准确、最新的天气预报
  • 为任何位置提供每小时天气数据
  • 访问温度、天气状况和其他天气详情

前提条件

  • Node.js ≥18
  • 一个 AccuWeather API 密钥(通过 .env 文件或 shell 设置)

设置

  1. 克隆此仓库: bash git clone https://github.com/TimLukaHorstmann/mcp-weather.git cd mcp-weather

  2. 安装依赖项: bash npm install

  3. 获取 AccuWeather API 密钥:

  4. 创建一个包含你的 API 密钥的 .env 文件:

    ACCUWEATHER_API_KEY=your_api_key_here

  5. 构建项目: bash npm run build

与 Claude Desktop 一起使用

  1. 配置 Claude Desktop 使用此 MCP 服务器:

    • 打开 Claude Desktop
    • 转到设置 > 开发者 > 编辑配置
    • 将以下内容添加到你的 claude_desktop_config.json 中:

    json { "mcpServers": { "weather": { "command": "npx", "args": ["-y", "@timlukahorstmann/mcp-weather"], "env": { "ACCUWEATHER_API_KEY": "your_api_key_here" } } } }

  2. 重启 Claude Desktop

  3. 在新的对话中,通过点击插件图标并选择 "weather" 来启用 MCP 服务器

  4. 现在你可以向 Claude 询问天气预报,例如:

    • "纽约市的天气预报是什么?"
    • "明天伦敦会下雨吗?"
    • "今天下午东京的气温会有多高?"

开发

  • 安装开发依赖项:npm install
  • 代码检查:npm run lint
  • 构建:npm run build
  • 运行测试:npm test
  • 以开发模式启动:npm run dev

贡献

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

许可证

本项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。

工具列表

  • weather-get_hourly: Get hourly weather forecast for the next 12 hours

  • weather-get_daily: Get daily weather forecast for up to 15 days

服务配置

[{'mcpServers': {'weather': {'args': ['-y', '@timlukahorstmann/mcp-weather'], 'command': 'npx', 'env': {'ACCUWEATHER_API_KEY': 'your_api_key_here'}}}}, {'mcpServers': {'weather': {'args': ['-y', '@timlukahorstmann/mcp-weather'], 'command': 'npx', 'env': {'ACCUWEATHER_API_KEY': 'your_api_key_here'}}}}]

来源