weather-mcp-server
A lightweight Model Context Protocol (MCP) server that enables AI assistants like Claude to retrieve and interpret real-time weather data. Discuss on Hacker News:
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/ezh0v--weather-mcp-server)HTML
<a href="/listings/ezh0v--weather-mcp-server"><img src="/api/listings/ezh0v--weather-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
To use your MCP server with Claude Desktop, add it to your Claude configuration:
1. Local mode
{
"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
{
"mcpServers": {
"weather-mcp-server": {
"url": "http://host:port/sse"
}
}
}What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 135 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <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).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.