Skip to main content
Glama
Ansh642

MCP Weather Data Fetcher

by Ansh642
README.md
# šŸŒ¤ļø MCP Weather Data Fetcher

A simple yet powerful weather-fetching tool built using the Model Context Protocol (MCP). This service allows AI agents to retrieve live weather updates for any city via OpenWeatherMap, wrapped in an agent-friendly format using MCP standards.

---

## šŸš€ Features

- Real-time weather data via OpenWeatherMap API  
- MCP-compatible tool (`getWeatherData`)  
- Returns structured details: temperature, humidity, wind speed, and description  
- Agent-friendly response formatting  
- CLI-compatible using Stdio transport  

---

## šŸ›  Tech Stack

- Node.js  
- MCP SDK (`@modelcontextprotocol/sdk`)  
- OpenWeatherMap API  
- zod (for input validation)  
- dotenv  

---

## šŸ“¦ Setup

1. Clone the repo & install dependencies:

```bash
git clone https://github.com/Ansh642/MCP-Server.git
cd mcp-weather-fetcher
npm install
````

2. Create a `.env` file with your OpenWeatherMap API key:

```env
OPENWEATHER_API_KEY=your_api_key_here
```

3. Run the MCP server:

```bash
node index.js
```

4. (Optional) Define the server in `mcp.json`:

```json
{
  "mcpServers": {
    "weatherData": {
      "command": "node",
      "args": ["C:/Users/91995/Desktop/mcpServer/index.js"]
    }
  }
}
```

---

## šŸ’¬ Example Interaction

```bash
>> Call tool: getWeatherData with { "city": "Delhi" }

āœ… Weather Report for Delhi:
- Temperature: 34.9°C
- Feels Like: 37.1°C
- Humidity: 45%
- Weather: Clear
- Description: clear sky
- Wind Speed: 3.6 m/s
```

---

## šŸ‘¤ Author

**Ansh Agarwal**
šŸ“§ [anshagarwal642@gmail.com](mailto:anshagarwal642@gmail.com)
šŸ”— [GitHub](https://github.com/Ansh642) | [LinkedIn](https://www.linkedin.com/in/ansh-agarwal-b830b3218)

---

```