天气查询 MCP 服务

这是一个简单的天气查询MCP（Model Completion Plugin）服务，可以让你通过Cursor AI助手查询全球城市的天气状况。

准备工作

1. 注册并获取OpenWeatherMap API密钥：

   • 访问 OpenWeatherMap 网站
   • 注册一个免费账户
   • 获取API密钥

2. 配置环境变量：

   • 在项目根目录中找到.env文件
   • 将你的API密钥填入OPENWEATHER_API_KEY=your_api_key_here

本地运行

1. 安装依赖：

npm install

2. 启动服务：

npm start

或者使用开发模式（自动重启）：

npm run dev

3. 服务将在 http://localhost:3001 上运行
   • MCP清单: http://localhost:3001/mcp-manifest.json
   • OpenAPI规范: http://localhost:3001/openapi.json

部署到公网

为了让Cursor能够使用这个MCP服务，你需要将其部署到公网可访问的地址。以下是几种简单的方法：

使用ngrok进行临时公开（开发测试用）

1. 安装ngrok：

   • 访问 ngrok.com 注册并下载
   • 按照官方指南设置ngrok

2. 在本地启动你的服务：

npm start

3. 在另一个终端窗口启动ngrok：

ngrok http 3001

4. ngrok会提供一个公开URL（例如 https://abc123.ngrok.io）
   • 使用这个URL来配置Cursor中的MCP服务

部署到Render.com（免费方案）

1. 注册 Render.com 账户

2. 创建新的Web服务：

   • 连接你的GitHub仓库
   • 设置构建命令：npm install
   • 设置启动命令：npm start
   • 添加环境变量：OPENWEATHER_API_KEY

3. 部署完成后，Render会提供一个类似于 https://your-service-name.onrender.com 的URL

   • 使用这个URL来配置Cursor中的MCP服务

在Cursor中配置MCP服务

1. 打开Cursor编辑器
2. 点击设置图标
3. 选择"MCP服务"
4. 点击"添加MCP服务"
5. 输入你的MCP清单URL（例如https://your-service.onrender.com/mcp-manifest.json）
6. 保存设置

现在你可以通过Cursor AI助手查询天气了，例如：

• "北京今天的天气怎么样？"
• "查询上海的气温"
• "纽约现在的天气状况"

API使用

如果你想直接调用API，可以使用以下端点：

GET /weather?city={城市名}

示例响应：

{
  "city": "北京",
  "temperature": 25.6,
  "description": "晴",
  "humidity": 45,
  "wind_speed": 5.7
}

许可证

MIT