[](https://mseep.ai/app/shibing624-weather-forecast-server)
# Weather Forecast MCP Server
A Model Context Protocol (MCP) server for retrieving weather information using the wttr.in service.
## Overview
This MCP server provides tools for accessing current weather conditions and forecasts for locations worldwide.
It can be easily integrated with MCP clients, including Claude and other LLM applications supporting the MCP protocol.
## Features
- Get current weather for any location
- Get multi-day weather forecasts (up to 3 days)
- Support for both Chinsee/English and other language location names
- Easy integration with MCP client applications
## Installation
### From pip
You can install the MCP Weather Server using `uv`:
```bash
uv pip install weather-forecast-server
```
Or using pip:
```bash
pip install weather-forecast-server
```
### From source
```bash
git clone https://github.com/shibing624/mcp-server-weather.git
cd weather-forecast-server
pip install -e .
```
## Usage
### Python Demo
```python
from weather_forecast_server import get_weather
print(get_weather('baoding')) # can be "baoding" or "保定"
```
### Running as a standalone MCP server
Run the server with the stdio transport:
```bash
uvx weather-forecast-server
```
or
```bash
uv run weather-forecast-server
```
or
```bash
python -m weather_forecast_server
```
Then, you can use the server with any MCP client that supports stdio transport.
### Integrating with Cursor
To add the weather MCP server to Cursor, add stdio MCP with command:
```bash
uv run weather-forecast-server
```
### Tools available
- `get_weather` - Get current weather conditions for a location (up to 3 days)
## Contact
- Issues and suggestions: [](https://github.com/shibing624/weather-forecast-server/issues)
- Email: xuming624@qq.com
- WeChat: Add me (WeChat ID: xuming624) with the message: "Name-Company-NLP" to join our NLP discussion group.
<img src="https://github.com/shibing624/weather-forecast-server/blob/main/docs/wechat.jpeg" width="200" />
## License
This project is licensed under [The Apache License 2.0](/LICENSE) and can be used freely for commercial purposes.
Please include a link to the `weather-forecast-server` project and the license in your product description.
## Contribute
We welcome contributions to improve this project! Before submitting a pull request, please:
1. Add appropriate unit tests in the `tests` directory
2. Run `python -m pytest` to ensure all tests pass
3. Submit your PR with clear descriptions of the changes
## Acknowledgements
- Weather data provided by [wttr.in](https://wttr.in)
- Built with [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)
Raw data
{
"_id": null,
"home_page": "https://github.com/shibing624/weather-forecast-server",
"name": "weather-forecast-server",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "weather_forecast_server, weather forecast, server, weather, forecast",
"author": "XuMing",
"author_email": "xuming624@qq.com",
"download_url": "https://files.pythonhosted.org/packages/5b/15/e416a9a243851739af78523bc4077e0ad11d0204f82e047d357605c76a9a/weather_forecast_server-0.0.7.tar.gz",
"platform": null,
"description": "[](https://mseep.ai/app/shibing624-weather-forecast-server)\n\n# Weather Forecast MCP Server\n\nA Model Context Protocol (MCP) server for retrieving weather information using the wttr.in service.\n\n## Overview\n\nThis MCP server provides tools for accessing current weather conditions and forecasts for locations worldwide. \nIt can be easily integrated with MCP clients, including Claude and other LLM applications supporting the MCP protocol.\n\n## Features\n\n- Get current weather for any location\n- Get multi-day weather forecasts (up to 3 days)\n- Support for both Chinsee/English and other language location names\n- Easy integration with MCP client applications\n\n## Installation\n\n### From pip\nYou can install the MCP Weather Server using `uv`:\n\n```bash\nuv pip install weather-forecast-server\n```\n\nOr using pip:\n\n```bash\npip install weather-forecast-server\n```\n\n### From source\n```bash\ngit clone https://github.com/shibing624/mcp-server-weather.git\ncd weather-forecast-server\npip install -e .\n```\n\n## Usage\n### Python Demo\n```python\nfrom weather_forecast_server import get_weather\nprint(get_weather('baoding')) # can be \"baoding\" or \"\u4fdd\u5b9a\"\n```\n\n\n\n### Running as a standalone MCP server\n\nRun the server with the stdio transport:\n\n```bash\nuvx weather-forecast-server\n```\n\nor\n\n```bash\nuv run weather-forecast-server\n```\n\nor \n\n```bash\npython -m weather_forecast_server\n```\n\nThen, you can use the server with any MCP client that supports stdio transport.\n\n### Integrating with Cursor\n\nTo add the weather MCP server to Cursor, add stdio MCP with command:\n\n```bash\nuv run weather-forecast-server\n```\n\n\n\n### Tools available\n\n- `get_weather` - Get current weather conditions for a location (up to 3 days)\n\n\n\n## Contact\n\n- Issues and suggestions: [](https://github.com/shibing624/weather-forecast-server/issues)\n- Email: xuming624@qq.com\n- WeChat: Add me (WeChat ID: xuming624) with the message: \"Name-Company-NLP\" to join our NLP discussion group.\n\n<img src=\"https://github.com/shibing624/weather-forecast-server/blob/main/docs/wechat.jpeg\" width=\"200\" />\n\n\n## License\n\nThis project is licensed under [The Apache License 2.0](/LICENSE) and can be used freely for commercial purposes. \nPlease include a link to the `weather-forecast-server` project and the license in your product description.\n## Contribute\n\nWe welcome contributions to improve this project! Before submitting a pull request, please:\n\n1. Add appropriate unit tests in the `tests` directory\n2. Run `python -m pytest` to ensure all tests pass\n3. Submit your PR with clear descriptions of the changes\n\n## Acknowledgements\n\n- Weather data provided by [wttr.in](https://wttr.in)\n- Built with [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) \n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "weather-forecast-server: MCP server for weather forecast",
"version": "0.0.7",
"project_urls": {
"Homepage": "https://github.com/shibing624/weather-forecast-server"
},
"split_keywords": [
"weather_forecast_server",
" weather forecast",
" server",
" weather",
" forecast"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5b15e416a9a243851739af78523bc4077e0ad11d0204f82e047d357605c76a9a",
"md5": "449be8a1cd0fbc00a3baebbe92a69c99",
"sha256": "b1ed6971039ad9d82aa2f8b6dc7a5974e31d7b83ed30773e773c9906cf8e5cfd"
},
"downloads": -1,
"filename": "weather_forecast_server-0.0.7.tar.gz",
"has_sig": false,
"md5_digest": "449be8a1cd0fbc00a3baebbe92a69c99",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 8960,
"upload_time": "2025-10-21T11:29:43",
"upload_time_iso_8601": "2025-10-21T11:29:43.018782Z",
"url": "https://files.pythonhosted.org/packages/5b/15/e416a9a243851739af78523bc4077e0ad11d0204f82e047d357605c76a9a/weather_forecast_server-0.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-21 11:29:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "shibing624",
"github_project": "weather-forecast-server",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "mcp",
"specs": []
},
{
"name": "requests",
"specs": []
},
{
"name": "loguru",
"specs": []
}
],
"lcname": "weather-forecast-server"
}
JSON
