Weather Agent MCP Server

# Weather Agent MCP Server A sample MCP server that provides weather information for a specified city using the OpenWeatherMap API. ## Description This project implements a simple Model Context Protocol (MCP) server called "Weather Bot". It exposes a single tool that fetches current weather data for a given city, including temperature in Celsius, humidity, and weather description. The server communicates via standard I/O (stdio) and can be integrated with MCP-compatible clients. Tested on Apple M1 Air. <img src="Claude-Desktop.png" alt="Test Result" width="500px"/> ## Features - Get current weather information for any city - Returns formatted weather data including description, temperature (°C), and humidity - Integrates with OpenWeatherMap API for up-to-the-minute weather data ## Installation 1. Clone or download this repository to your local machine. 2. Install the required dependencies: ``` pip install -r requirements.txt ``` ## Configuration 1. Get an API key from [OpenWeatherMap](https://openweathermap.org/api) 2. Create a `.env` file in the project root and add your API key: ``` WEATHER_API_KEY=your_api_key_here ``` **Security Note:** Never commit your `.env` file to version control. Ensure it's included in your `.gitignore`. ## Usage Run the MCP server using: ``` python weather_agent.py ``` The server starts and listens for MCP protocol messages via stdio. It can be integrated with MCP-compatible applications or clients. ## Integration with Claude Desktop To test this MCP server with Claude Desktop, follow these steps: 1. Ensure Claude Desktop is installed on your machine. 2. Locate your `claude_desktop_config.json` file. On macOS, it's typically located at `~/Library/Application Support/Claude/claude_desktop_config.json`. You can also open the path by openging via UI, Claude > Settings > Developer > Edit Config. 3. Open the `claude_desktop_config.json` file and add the following configuration inside the JSON object (add to the "mcpServers" object if it exists, or create it): ```json { "mcpServers": { "weather-agent": { "command": "python", "args": ["/path/to/your/mcp-server/weather_agent.py"] } } } ``` Replace `/path/to/your/mcp-server/weather_agent.py` with the absolute path to your `weather_agent.py` file. For example, the path might be `/Users/yourusername/Desktop/mcp-server/weather_agent.py`. 4. Save the `claude_desktop_config.json` file. 5. Restart Claude Desktop to load the new configuration. 6. In Claude Desktop, you can now interact with the weather agent. For example, ask Claude: "What's the weather in Tokyo?" and it should use the MCP server to fetch and return the weather information. **Note:** Ensure that your API key is configured in the `.env` file as described in the Configuration section, and that the Python environment is set up to run the script (e.g., the required packages are installed). ## API ### get_weather(city: str) -> str Fetches current weather information for the specified city. **Parameters:** - `city`: String - The name of the city to get weather for **Returns:** A formatted string containing: - City name - Weather description - Current temperature in Celsius - Humidity percentage **Example Response:** ``` The current weather in London is overcast clouds with a temperature of 15°C and humidity of 72%. ``` ## Dependencies - `requests`: For making HTTP requests to the weather API - `python-dotenv`: For loading environment variables from .env file - `fastmcp`: MCP server framework ## Error Handling If the weather API returns an error or the city is not found, the tool will return an error message indicating the failure to fetch data. ## License This is a sample project. Feel free to modify and use as needed.