https://github.com/jackkuo666/weather-mcp-server
https://github.com/jackkuo666/weather-mcp-server
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jackkuo666/weather-mcp-server
- Owner: JackKuo666
- Created: 2025-03-17T13:41:15.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2025-03-18T08:58:23.000Z (7 months ago)
- Last Synced: 2025-06-17T13:07:05.098Z (4 months ago)
- Language: Python
- Size: 20.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Weather MCP Server
This is a Model Context Protocol (MCP) server that provides weather information using the National Weather Service (NWS) API.
## Features
- Get weather alerts for a US state
- Get weather forecast for a specific location (using latitude and longitude)
## Requirements
- Python 3.10+
- FastMCP
- httpx
## Installation
1. Clone this repository
2. Set up a virtual environment:
```
python -m venv .venv
source .venv/bin/activate # On Windows, use `.venv\Scripts\activate`
```
3. Install the required packages using uv:
```
uv add "mcp[cli]" httpx
```
## Configuration
The server uses a configuration file `config.py` with the following settings:
- `NWS_API_BASE`: The base URL for the National Weather Service API
- `USER_AGENT`: The User-Agent string used when making requests to the NWS API
- `LOG_LEVEL`: The logging level (e.g., "INFO", "DEBUG")
- `LOG_FORMAT`: The format string for log messages
- `REQUEST_TIMEOUT`: The timeout for API requests in seconds
You can modify these settings in the `config.py` file to customize the server behavior.
## Usage
### Running the server standalone
To run the server standalone:
1. Activate the virtual environment if not already activated:
```
source .venv/bin/activate # On Windows, use `.venv\Scripts\activate`
```
2. Run the server:
```
python weather.py
```
### Using with Cline
The Weather MCP Server has been added to the Cline configuration. To use it within Cline:
1. Ensure that Cline is properly set up and running.
2. The Weather MCP Server will be available as a tool named "weather".
3. You can use the following tools within Cline:
a. `get_alerts(state: str)`: Get weather alerts for a US state (use two-letter state code, e.g., "CA" for California)
b. `get_forecast(latitude: float, longitude: float)`: Get weather forecast for a specific location
Example usage in Cline:
```
# Get alerts for California
result = await mcp.call_tool("weather.get_alerts", state="CA")
print(result)
# Get forecast for San Francisco (approximate coordinates)
result = await mcp.call_tool("weather.get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)
```
Note: The exact syntax for calling MCP tools may vary depending on your Cline setup. Refer to Cline documentation for the most up-to-date usage instructions.
## Error Handling and Logging
The server includes improved error handling for API requests and logging. If an error occurs during a request, the server will log the error and return an appropriate error message. Logs are printed to the console with the configured log level and format.
## Testing
### Unit Tests
To run the unit tests:
```
python -m unittest test_weather.py
```
These tests cover the basic functionality of the `get_alerts` and `get_forecast` tools.
### Manual Testing
To manually test the server, you can use the MCP client to call the provided tools. Here are some example commands:
```python
# Get alerts for California
result = await mcp.call_tool("get_alerts", state="CA")
print(result)
# Get forecast for San Francisco (approximate coordinates)
result = await mcp.call_tool("get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)
```
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is open source and available under the [MIT License](LICENSE).