🚀 天气查询 MCP 服务
这是一个简单的天气查询MCP（模型完成插件）服务，可让你通过Cursor AI助手查询全球城市的天气状况，为你提供便捷的天气信息获取途径。
🚀 快速开始
✨ 主要特性
- 借助Cursor AI助手，可查询全球城市的天气状况。
- 提供多种部署方式，方便在不同场景使用。
- 支持直接调用API获取天气信息。
📦 安装指南
准备工作
- 注册并获取OpenWeatherMap API密钥：
- 访问 OpenWeatherMap 网站。
- 注册一个免费账户。
- 获取API密钥。
- 配置环境变量：
- 在项目根目录中找到
.env文件。 - 将你的API密钥填入
OPENWEATHER_API_KEY=your_api_key_here。
- 在项目根目录中找到
本地运行
- 安装依赖：
npm install
- 启动服务：
npm start
或者使用开发模式（自动重启）：
npm run dev
- 服务将在 http://localhost:3001 上运行：
- MCP清单: http://localhost:3001/mcp-manifest.json
- OpenAPI规范: http://localhost:3001/openapi.json
部署到公网
为了让Cursor能够使用这个MCP服务，你需要将其部署到公网可访问的地址。以下是几种简单的方法：
使用ngrok进行临时公开（开发测试用）
- 安装ngrok：
- 访问 ngrok.com 注册并下载。
- 按照官方指南设置ngrok。
- 在本地启动你的服务：
npm start
- 在另一个终端窗口启动ngrok：
ngrok http 3001
- ngrok会提供一个公开URL（例如
https://abc123.ngrok.io），使用这个URL来配置Cursor中的MCP服务。
部署到Render.com（免费方案）
- 注册 Render.com 账户。
- 创建新的Web服务：
- 连接你的GitHub仓库。
- 设置构建命令：
npm install。 - 设置启动命令：
npm start。 - 添加环境变量：
OPENWEATHER_API_KEY。
- 部署完成后，Render会提供一个类似于
https://your-service-name.onrender.com的URL，使用这个URL来配置Cursor中的MCP服务。
💻 使用示例
在Cursor中配置MCP服务
- 打开Cursor编辑器。
- 点击设置图标。
- 选择"MCP服务"。
- 点击"添加MCP服务"。
- 输入你的MCP清单URL（例如
https://your-service.onrender.com/mcp-manifest.json）。 - 保存设置。
现在你可以通过Cursor AI助手查询天气了，例如：
- "北京今天的天气怎么样？"
- "查询上海的气温"
- "纽约现在的天气状况"
API使用
如果你想直接调用API，可以使用以下端点：
GET /weather?city={城市名}
示例响应：
{
"city": "北京",
"temperature": 25.6,
"description": "晴",
"humidity": 45,
"wind_speed": 5.7
}
📄 许可证
本项目采用MIT许可证。