{"id":31065144,"url":"https://github.com/zkjon/mcp-weather","last_synced_at":"2026-05-18T02:11:49.212Z","repository":{"id":310964266,"uuid":"1041922904","full_name":"zkjon/mcp-weather","owner":"zkjon","description":"MCP server to get the weather from a location","archived":false,"fork":false,"pushed_at":"2025-08-21T11:39:37.000Z","size":25,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-15T15:46:17.102Z","etag":null,"topics":["mcp","mcp-server","template","wheather"],"latest_commit_sha":null,"homepage":"https://mcp-weather-web.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zkjon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-21T08:02:43.000Z","updated_at":"2025-08-28T06:58:14.000Z","dependencies_parsed_at":"2025-08-21T10:33:14.491Z","dependency_job_id":"7bc0bd8d-9f1d-49fd-9bff-5c4678847b1d","html_url":"https://github.com/zkjon/mcp-weather","commit_stats":null,"previous_names":["zkjon/mcp-wheather"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/zkjon/mcp-weather","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zkjon%2Fmcp-weather","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zkjon%2Fmcp-weather/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zkjon%2Fmcp-weather/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zkjon%2Fmcp-weather/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zkjon","download_url":"https://codeload.github.com/zkjon/mcp-weather/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zkjon%2Fmcp-weather/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33162448,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"online","status_checked_at":"2026-05-18T02:00:06.436Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp","mcp-server","template","wheather"],"created_at":"2025-09-15T15:45:59.476Z","updated_at":"2026-05-18T02:11:49.178Z","avatar_url":"https://github.com/zkjon.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP Weather Server 🌤️\n\nA Model Context Protocol (MCP) server that provides real-time weather information using the [Open-Meteo API](https://open-meteo.com/).\n\n## 📋 Description\n\nThis project implements an MCP server that allows AI models to obtain current weather information for any location worldwide. The server uses [Open-Meteo's](https://open-meteo.com/) free APIs for geocoding and weather data.\n\n## 🔍 Documentation\n\nCheck out the [documentation](https://deepwiki.com/zkjon/mcp-weather) for more details on how to work with this server.\n\n## ✨ Features\n\n- 🌍 **Global coverage**: Get weather information from any location worldwide\n- 🔄 **Real-time data**: Up-to-date weather information\n- 📊 **Complete data**: Temperature, humidity, precipitation, wind, cloud cover\n- 🚀 **Fast and efficient**: Quick responses with structured JSON data\n- 🔧 **Easy integration**: Compatible with any MCP client\n\n## 🛠️ Installation\n\n### Prerequisites\n\n- [Bun](https://bun.sh/) (recommended) or Node.js 20+\n\n### Installation Steps\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/zkjon/mcp-weather.git\n   cd mcp-weather\n   ```\n\n2. **Install dependencies**\n   ```bash\n   bun install\n   # or\n   npm install\n   ```\n\n3. **Run the server**\n   ```bash\n   bunx -y tsx src/main.ts\n   # or\n   npx -y tsx src/main.ts\n   ```\n\n## 🚀 Usage\n\n### MCP Configuration\n\nTo use this server with an MCP client, add the following configuration to your `mcp.json` file:\n\n```json\n{\n    \"mcpServers\": {\n        \"Weather\": {\n            \"command\": \"bunx\",\n            \"args\": [\n                \"-y\",\n                \"tsx\",\n                \"C:\\\\full\\\\path\\\\to\\\\project\\\\src\\\\main.ts\"\n            ]\n        }\n    }\n}\n```\n\n### Available Tools\n\n#### `get-weather`\n\nGets weather information for a specific location.\n\n**Parameters:**\n- `location` (string): Location name (city, country, etc.)\n\n**Usage Example:**\n```javascript\n// Request\n{\n    \"tool\": \"get-weather\",\n    \"arguments\": {\n        \"location\": \"Madrid\"\n    }\n}\n\n// Response\n{\n    \"content\": [\n        {\n            \"type\": \"text\",\n            \"text\": \"{\n                \\\"latitude\\\": 40.4375,\n                \\\"longitude\\\": -3.6875,\n                \\\"current\\\": {\n                    \\\"temperature_2m\\\": 18.7,\n                    \\\"relative_humidity_2m\\\": 54,\n                    \\\"precipitation\\\": 0,\n                    \\\"rain\\\": 0,\n                    \\\"cloud_cover\\\": 4,\n                    \\\"wind_speed_10m\\\": 6.1\n                }\n            }\"\n        }\n    ]\n}\n```\n\n### Workflow\n\n1. **Request reception**: Server receives a request with a location\n2. **Geocoding**: Location coordinates are obtained using Open-Meteo API\n3. **Weather query**: Weather data is queried using the coordinates\n4. **Structured response**: Data is returned in structured JSON format\n\n### Code Structure\n\n- **Imports**: MCP SDK and necessary libraries\n- **Server configuration**: MCP server definition with name and version\n- **Tool definition**: Implementation of the `get-weather` tool\n- **Connection**: Transport configuration and server connection\n\n## 🌐 APIs Used\n\n- **[Open-Meteo Geocoding API](https://open-meteo.com/en/docs/geocoding-api)**: To convert location names to coordinates\n- **[Open-Meteo Weather API](https://open-meteo.com/en/docs)**: To get current weather data\n\n## 📝 License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n## 🤝 Contributing\n\nContributions are welcome! Please read our [contribution guide](CONTRIBUTING.md) for more information.\n\n## 🔒 Security\n\nIf you find any security vulnerability, please check our [security file](SECURITY.md) to know how to report it.\n\n## 📞 Support\n\nIf you have questions or need help:\n\n- 🐛 **Report bugs**: [Issues](https://github.com/zkjon/mcp-weather/issues)\n- 💡 **Request features**: [Issues](https://github.com/zkjon/mcp-weather/issues)\n- 📧 **Contact**: [zkjon](https://github.com/zkjon)\n\n## 🙏 Acknowledgments\n\n- [Open-Meteo](https://open-meteo.com/) for providing free weather APIs\n- [Model Context Protocol](https://modelcontextprotocol.io/) for the MCP framework\n- [Bun](https://bun.sh/) for the fast JavaScript runtime\n\n---\n\n**Made with ❤️ by [zkjon](https://github.com/zkjon)**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzkjon%2Fmcp-weather","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzkjon%2Fmcp-weather","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzkjon%2Fmcp-weather/lists"}