weather-mcp-server

<div align="center"> <img alt="example output template" src="assets/weather.svg"> <h1>Weather API MCP Server</h1> [](LICENSE) [](go.mod) [](https://goreportcard.com/report/github.com/ezh0v/weather-mcp-server) [](https://github.com/ezh0v/weather-mcp-server/actions?workflow=Build) [](https://github.com/ezh0v/weather-mcp-server/actions?workflow=Test) <strong>[Report Bug](https://github.com/ezh0v/weather-mcp-server/issues/new?assignees=&labels=bug&projects=&template=bug_report.yml)</strong> | <strong>[Request Feature](https://github.com/ezh0v/weather-mcp-server/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.yml)</strong> </div> A lightweight Model Context Protocol (MCP) server that enables AI assistants like Claude to retrieve and interpret real-time weather data. <div align="center"> <img alt="demo example" src="assets/weather.gif" width="480"> </div> ## Installing on Claude Desktop To use your MCP server with Claude Desktop, add it to your Claude configuration: #### 1. Local mode ```json { "mcpServers": { "weather-mcp-server": { "command": "/path/to/weather-mcp-server", "env": { "WEATHER_API_KEY": "your-api-key" } } } } ``` You can get an API key from your personal account on [WeatherAPI](https://www.weatherapi.com/my/). #### 2. Remote mode ```json { "mcpServers": { "weather-mcp-server": { "url": "http://host:port/sse" } } } ``` ## Build from source You can use `go` to build the binary in the `cmd/github-mcp-server` directory. ```shell go build -o weather-mcp-server ./cmd/weather-mcp-server ``` ## Using MCP with Docker Containers #### 1. Build the Docker Image: ```shell docker build -t weather-mcp-server . ``` #### 2. Run the Docker Container: ```shell docker run -e WEATHER_API_KEY=your-api-key -d --name weather-mcp-server -p 8000:8000 weather-mcp-server ``` Replace `your-api-key` with your actual [WeatherAPI](https://www.weatherapi.com/my/) API key. ## Tools - **current_weather** - Gets the current weather for a city - `city`: The name of the city (string, required) ## Project Structure The project is organized into several key directories: ```shell ├── cmd │ └── weather-mcp-server ├── internal │ └── server │ ├── handlers # MCP handlers │ ├── services # Business logic layer │ │ ├── core # Core application logic │ │ └── mock # Mock services for testing │ ├── tools # MCP tools │ └── view # Templates for displaying messages └── pkg ``` ## Testing If you're adding new features, please make sure to include tests for them. #### 1. Install the mockgen tool: ```shell go install go.uber.org/mock/mockgen@latest ``` See the installation guide on [go.uber.org/mock](https://github.com/uber-go/mock?tab=readme-ov-file#installation). #### 2. Use the following command to generate mock files: ```shell make generate-mocks ``` #### 3. To run unit tests: ```shell make run-tests ``` ## Contributing Feel free to open tickets or send pull requests with improvements. Thanks in advance for your help! Please follow the [contribution guidelines](.github/CONTRIBUTING.md). ## License This MCP server is licensed under the [MIT License](LICENSE).