Mymcp

🚀 Weather Query MCP Service

A simple Weather Query MCP (Model Completion Plugin) service that allows you to query the weather conditions of global cities through the Cursor AI assistant.

🚀 Quick Start

✨ Features

• Query the weather conditions of global cities via the Cursor AI assistant.
• Directly call the API to obtain weather information.

📦 Installation

Prerequisites

1. Register and obtain an OpenWeatherMap API key:
   • Visit the OpenWeatherMap website.
   • Register for a free account.
   • Get the API key.
2. Configure environment variables:
   • Find the .env file in the project root directory.
   • Fill in your API key as OPENWEATHER_API_KEY=your_api_key_here.

Local Run

1. Install dependencies:

npm install

2. Start the service:

npm start

Or use the development mode (auto-restart):

npm run dev

3. The service will run on http://localhost:3001
   • MCP manifest: http://localhost:3001/mcp-manifest.json
   • OpenAPI specification: http://localhost:3001/openapi.json

Deployment to the Public Network

To enable Cursor to use this MCP service, you need to deploy it to a publicly accessible address. Here are some simple methods:

Use ngrok for Temporary Public Access (for Development and Testing)

1. Install ngrok:
   • Visit ngrok.com to register and download.
   • Set up ngrok according to the official guide.
2. Start your service locally:

npm start

3. Start ngrok in another terminal window:

ngrok http 3001

4. ngrok will provide a public URL (e.g., https://abc123.ngrok.io)
   • Use this URL to configure the MCP service in Cursor.

Deploy to Render.com (Free Plan)

1. Register an account on Render.com.
2. Create a new Web service:
   • Connect your GitHub repository.
   • Set the build command: npm install.
   • Set the start command: npm start.
   • Add the environment variable: OPENWEATHER_API_KEY.
3. After the deployment is complete, Render will provide a URL similar to https://your-service-name.onrender.com
   • Use this URL to configure the MCP service in Cursor.

💻 Usage Examples

Configure the MCP Service in Cursor

1. Open the Cursor editor.
2. Click the settings icon.
3. Select "MCP Services".
4. Click "Add MCP Service".
5. Enter your MCP manifest URL (e.g., https://your-service.onrender.com/mcp-manifest.json).
6. Save the settings.

Now you can query the weather through the Cursor AI assistant, for example:

• "What's the weather like in Beijing today?"
• "Query the temperature in Shanghai."
• "What's the current weather condition in New York?"

API Usage

If you want to call the API directly, you can use the following endpoint:

GET /weather?city={city_name}

Example response:

{
  "city": "Beijing",
  "temperature": 25.6,
  "description": "Sunny",
  "humidity": 45,
  "wind_speed": 5.7
}

📄 License

MIT