🌤️ Weather MCP Server (Free & Sydney Default)

🌤️ 天气 MCP 服务（免费，默认悉尼）

一个通过免费 Open-Meteo API 获取天气数据的模型上下文协议（MCP）服务。无需 API 密钥！ 默认城市设置为悉尼。

✨ 功能

• 🆓 完全免费 - 使用 Open-Meteo API（无需密钥）
• 🇦🇺 默认悉尼 - 澳大利亚用户的理想选择
• 🌍 支持全球城市 - 覆盖全球所有城市
• 🗓️ 7 天预报 - 详细天气数据
• 🔍 城市搜索 - 轻松查找坐标
• 🌐 多语言 - 英文界面，支持法语

🚀 快速安装

1. 安装依赖项：

cd weather-mcp-server
npm install

2. 立即测试：

npm start

就是这样！ 无需其他配置。

🛠️ 使用 Claude Desktop 配置

将此配置添加到你的 claude_desktop_config.json：

Windows

文件：%APPDATA%\Claude\claude_desktop_config.json

macOS

文件：~/Library/Application Support/Claude/claude_desktop_config.json

JSON 配置

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "YOUR_FULL_PATH_HERE\\weather-mcp-server\\src\\index.js"
      ]
    }
  }
}

注意： 请根据你的安装位置调整路径！

🔧 可用工具

1. get_current_weather

当前天气（默认悉尼）

• city（可选）：城市名称（默认：Sydney）
• country（可选）：国家代码（AU、FR 等）

2. get_weather_forecast

7 天预报（默认悉尼）

• city（可选）：城市名称（默认：Sydney）
• country（可选）：国家代码
• days（可选）：天数，1-7 天（默认：7）

3. get_weather_by_coordinates

按 GPS 坐标查询天气（默认悉尼）

• lat（可选）：纬度（默认：-33.8688）
• lon（可选）：经度（默认：151.2093）
• days（可选）：天数，1-7 天（默认：1）

4. search_cities

搜索全球城市

• query（必填）：要搜索的城市名称

📝 Claude 使用示例

配置完成后，你可以向 Claude 提问：

默认天气（悉尼）：

• “天气怎么样？”
• “当前天气”
• “一周天气预报”

其他城市：

• “巴黎的天气”
• “伦敦的 5 天预报”
• “东京的气温”

城市搜索：

• “查找名为 Melbourne 的城市”
• “搜索 Springfield”

按坐标查询：

• “坐标 48.8566，2.3522 处的天气”

🌟 Open-Meteo 的优势

• ✅ 完全免费 - 没有合理使用限制
• ✅ 无需注册 - 立即可用
• ✅ 数据准确 - 专业气象模型
• ✅ 现代化 API - 简洁快速的 JSON
• ✅ 可靠 - 稳定的欧洲服务

🗺️ 为什么默认城市是悉尼？

默认城市设置为悉尼，原因如下：

• 🏙️ 大型都市 - 具有澳大利亚代表性
• 🌤️ 气候多变 - 适合作为天气示例
• 🇦🇺 独特时区 - 根据季节为 GMT+10/+11
• 📍 精确坐标 - -33.8688°，151.2093°

🐛 故障排除

“找不到城市”

• 检查拼写
• 尝试添加国家代码：“Paris, FR”
• 使用 search_cities 查找正确名称

网络错误

• 检查网络连接
• Open-Meteo 有时会暂时无法访问

服务无法启动

• 检查 Node.js：node --version（需要 ≥16）
• 安装依赖项：npm install

🔄 与 OpenWeatherMap 的比较

标准	Open-Meteo	OpenWeatherMap
价格	🆓 免费	🆓 免费（有限制）
API 密钥	❌ 无需	✅ 必需
注册	❌ 无需	✅ 必须
预报	7 天	5 天（免费版）
准确度	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐
可靠性	⭐⭐⭐⭐⭐	⭐⭐⭐⭐

📦 依赖项

• @modelcontextprotocol/sdk：官方 MCP SDK
• node-fetch：用于 API 请求的 HTTP 客户端

没有庞大的外部依赖项！

📄 许可证

MIT - 可在你的项目中自由使用！

---

🇦🇺 为悉尼和全世界倾情打造 ❤️

---

🇫🇷 法语版本 / 英文版本

🌤️ 天气 MCP 服务（免费，默认使用 Sydney）

一个通过免费 Open-Meteo API 获取天气数据的 MCP（Model Context Protocol）服务。无需 API 密钥！ 默认城市为 Sydney。

✨ 特点

• 🆓 100% 免费 - 使用 Open-Meteo API（无需密钥）
• 🇦🇺 默认使用 Sydney - 非常适合澳大利亚
• 🌍 支持全球城市 - 覆盖世界各地的所有城市
• 🗓️ 7 天预报 - 提供详细天气信息
• 🔍 搜索城市 - 轻松查找坐标
• 🌐 法语界面 - 提供法语描述

🚀 快速安装

1. 安装依赖项：

cd weather-mcp-server
npm install

2. 立即测试：

npm start

就是这么简单！ 无需额外配置。

🛠️ 配置 Claude Desktop

将以下配置添加到你的 claude_desktop_config.json 中：

Windows

文件：%APPDATA%\Claude\claude_desktop_config.json

macOS

文件：~/Library/Application Support/Claude/claude_desktop_config.json

JSON 配置

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": [
        "REMPLACEZ_PAR_VOTRE_CHEMIN\\weather-mcp-server\\src\\index.js"
      ]
    }
  }
}

注意： 请根据你的安装位置调整路径！

🔧 可用工具

1. get_current_weather

当前天气（默认使用 Sydney）

• city（可选）：城市名称（默认：Sydney）
• country（可选）：国家代码（AU、FR 等）

2. get_weather_forecast

7 天预报（默认使用 Sydney）

• city（可选）：城市名称（默认：Sydney）
• country（可选）：国家代码
• days（可选）：天数，范围为 1-7（默认：7）

3. get_weather_by_coordinates

通过 GPS 坐标查询天气（默认使用 Sydney）

• lat（可选）：纬度（默认：-33.8688）
• lon（可选）：经度（默认：151.2093）
• days（可选）：天数，范围为 1-7（默认：1）

4. search_cities

搜索世界各地的城市

• query（必填）：要搜索的城市名称

📝 使用 Claude 的示例

配置完成后，你可以向 Claude 提问：

查询默认城市（Sydney）的天气：

• “天气怎么样？”
• “当前天气”
• “本周天气预报”

查询其他城市：

• “Paris 的天气”
• “London 未来 5 天的天气预报”
• “Tokyo 的气温”

搜索城市：

• “查找名为 Melbourne 的城市”
• “搜索 Springfield”

通过坐标查询：

• “查询坐标 48.8566, 2.3522 处的天气”

🌟 Open-Meteo 的优势

• ✅ 完全免费 - 没有合理使用量限制
• ✅ 无需注册 - 即刻可用
• ✅ 数据准确 - 使用专业气象模型
• ✅ 现代化 API - JSON 格式简单快捷
• ✅ 可靠 - 稳定的欧洲服务

🗺️ 为什么默认使用 Sydney？

默认城市设置为 Sydney，原因如下：

• 🏙️ 大型都市 - 可代表澳大利亚
• 🌤️ 气候多样 - 是很好的天气示例
• 🇦🇺 时区独特 - 根据季节为 GMT+10/+11
• 📍 坐标准确 - -33.8688°、151.2093°

🐛 故障排除

“未找到城市”

• 检查拼写
• 尝试使用国家代码：“Paris, FR”
• 使用 search_cities 查找正确的名称

网络错误

• 检查互联网连接
• Open-Meteo 有时会暂时无法使用

服务无法启动

• 检查 Node.js：node --version（需要 ≥16）
• 安装依赖项：npm install

🔄 与 OpenWeatherMap 的比较

指标	Open-Meteo	OpenWeatherMap
价格	🆓 免费	🆓 免费（有限制）
API 密钥	❌ 不需要	✅ 必需
注册	❌ 不需要	✅ 必须
预报	7 天	5 天（免费版）
准确度	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐
可靠性	⭐⭐⭐⭐⭐	⭐⭐⭐⭐

📦 依赖项

• @modelcontextprotocol/sdk：官方 MCP SDK
• node-fetch：用于 API 请求的 HTTP 客户端

没有繁重的外部依赖项！

📄 许可证

MIT - 可在您的项目中自由使用！

---

🇦🇺 为悉尼和全世界倾注 ❤️ 打造