article
README
🚀 Weather MCP 服务器
Weather MCP 服务器是一个 Cline MCP 服务器,借助 OpenWeatherMap API 为用户提供实时的天气数据,满足用户对全球天气信息的查询需求。
🚀 快速开始
Weather MCP 服务器可帮助你轻松获取全球各地的天气信息。你只需按照以下步骤操作,即可快速使用该服务。
✨ 主要特性
- 实时天气查询:能够获取全球任何地点的当前天气状况。
- 未来天气预测:可获取未来五天的天气预报信息。
- 单位制支持:支持.metric 和 imperial 两种单位制。
- 高效缓存机制:采用效率缓存以最小化 API 调用。
- 美观响应格式:提供美观格式化的 Markdown 响应。
📦 安装指南
- 首先,你需要在 OpenWeatherMap 注册免费 API 密钥。
- 克隆此仓库:
git clone https://github.com/yourusername/weather-mcp.git cd weather-mcp npm install npm run build - 将 MCP 服务器添加到您的 Cline 设置中:
{ "mcpServers": { "weather-mcp": { "command": "node", "args": [ "/path/to/weather-mcp/build/index.js" ], "env": { "OPENWEATHERMAP_API_KEY": "YOUR_API_KEY", "WEATHER_UNITS": "metric" }, "disabled": false, "autoApprove": [] } } } - 设置
WEATHER_UNITS为.metric(°C,m/s)或 imperial(°F,mph)。
💻 使用示例
基础用法
获取当前天气状况
# 使用 get_current_weather 工具获取当前天气
# 假设要获取伦敦的当前天气
get_current_weather --location "London"
获取未来天气预报
# 使用 get_weather_forecast 工具获取未来天气预报
# 假设要获取伦敦未来 3 天的天气预报
get_weather_forecast --location "London" --days 3
高级用法
# 如果你想获取带国家代码的城市的未来 5 天天气预报
get_weather_forecast --location "London,uk" --days 5
📚 详细文档
可用工具
get_current_weather
此工具用于获取指定位置的当前天气状况。 参数:
location: 城市名称(例如 'London'),或带国家代码的城市名称(例如 'London,uk')
get_weather_forecast
此工具用于获取指定位置的未来五天天气预报。 参数:
location: 城市名称(例如 'London'),或带国家代码的城市名称(例如 'London,uk')days: 预报的天数(1 - 5,默认值:3)
🔧 技术细节
本项目在开发过程中,为了提高性能和减少 API 调用次数,采用了效率缓存机制。同时,使用 OpenWeatherMap API 来获取全球的天气数据,确保数据的准确性和及时性。在响应格式上,采用了美观的 Markdown 格式,方便用户查看和使用。
📄 许可证
本项目采用 MIT 许可证。
微信扫一扫