{"_id":"@chenxming/mcp-weather-server","_rev":"3-d41bf52372c5db62305f6ceb7708969c","name":"@chenxming/mcp-weather-server","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@chenxming/mcp-weather-server","version":"1.0.0","keywords":["mcp","weather","china","global","openweathermap","nws","model-context-protocol","claude","ai-tools","weather-api"],"author":{"name":"chenxming","email":"13716873821@163.com"},"license":"MIT","_id":"@chenxming/mcp-weather-server@1.0.0","maintainers":[{"name":"chenxming","email":"13716873821@163.com"}],"homepage":"https://github.com/your-username/mcp-weather-server#readme","bugs":{"url":"https://github.com/your-username/mcp-weather-server/issues"},"bin":{"mcp-weather":"build/index.js"},"dist":{"shasum":"6a0739c542b12190533b4fe73a25d3992148aabd","tarball":"https://registry.npmjs.org/@chenxming/mcp-weather-server/-/mcp-weather-server-1.0.0.tgz","fileCount":4,"integrity":"sha512-06zy+wt9baREWEqF3VdPiZr4hUlN+cFZEa4Dgb+BiDrcoj6e8yz2qQSgfZyEtXJ7lPIyxiZopcUO27tUduC05w==","signatures":[{"sig":"MEUCIATiaDLCNawsmqE4Lrs7ZEJxxSd85an8s0EFL9nik/bzAiEAr+lI+MauwMvQPpudIc8u5v8U5duq55nX1IBlNJ0L/uQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19619},"main":"./build/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"dev":"tsc --watch","test":"echo \"Error: no test specified\" && exit 1","build":"tsc && chmod 755 build/index.js","clean":"rm -rf build/","start":"node build/index.js","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"chenxming","actor":{"name":"chenxming","type":"user","email":"13716873821@163.com"},"email":"13716873821@163.com"},"repository":{"url":"git+https://github.com/your-username/mcp-weather-server.git","type":"git"},"_npmVersion":"10.9.2","description":"全球天气MCP服务器，支持中国城市和全球天气查询 - Global Weather MCP Server with support for Chinese cities","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.71","@modelcontextprotocol/sdk":"^1.13.3"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.10"},"peerDependencies":{},"optionalDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/mcp-weather-server_1.0.0_1751533904619_0.9719404208617062","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@chenxming/mcp-weather-server","version":"1.0.1","keywords":["mcp","weather","china","global","openweathermap","nws","model-context-protocol","claude","ai-tools","weather-api"],"author":{"name":"chenxming","email":"13716873821@163.com"},"license":"MIT","_id":"@chenxming/mcp-weather-server@1.0.1","maintainers":[{"name":"chenxming","email":"13716873821@163.com"}],"homepage":"https://github.com/your-username/mcp-weather-server#readme","bugs":{"url":"https://github.com/your-username/mcp-weather-server/issues"},"bin":{"mcp-weather":"build/index.js"},"dist":{"shasum":"e5cd14af9bca791496f229bcdb55a8e426664642","tarball":"https://registry.npmjs.org/@chenxming/mcp-weather-server/-/mcp-weather-server-1.0.1.tgz","fileCount":4,"integrity":"sha512-JtRkjIWeWlnypVb+gNTgIJtGMXs+PMQhwQd0RxXxEDWMluJTaIs1O/KSe3UoEXbjL/H16i1abVm9M/ToqGhpgg==","signatures":[{"sig":"MEUCIQD3RE3XeBb+/acu3ey5jdgCqbbtwNQ6cGZ6yMJ0Mp4gkwIgHp5+ubBvTa4wNE7Lwm7IMrmT7Mp2gPi6ioDbW/oXcuM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19591},"main":"./build/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"dev":"tsc --watch","test":"echo \"Error: no test specified\" && exit 1","build":"tsc && chmod 755 build/index.js","clean":"rm -rf build/","start":"node build/index.js","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"chenxming","actor":{"name":"chenxming","type":"user","email":"13716873821@163.com"},"email":"13716873821@163.com"},"repository":{"url":"git+https://github.com/your-username/mcp-weather-server.git","type":"git"},"_npmVersion":"10.9.2","description":"全球天气MCP服务器，支持中国城市和全球天气查询 - Global Weather MCP Server with support for Chinese cities","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.71","@modelcontextprotocol/sdk":"^1.13.3"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.10"},"peerDependencies":{},"optionalDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/mcp-weather-server_1.0.1_1751534038716_0.5629926299018972","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@chenxming/mcp-weather-server","version":"1.0.2","description":"全球天气MCP服务器，支持中国城市和全球天气查询 - Global Weather MCP Server with support for Chinese cities","main":"./build/index.js","type":"module","bin":{"mcp-weather":"build/index.js"},"scripts":{"build":"tsc && chmod 755 build/index.js","start":"node build/index.js","dev":"tsc --watch","clean":"rm -rf build/","prepublishOnly":"npm run clean && npm run build","test":"echo \"Error: no test specified\" && exit 1"},"keywords":["mcp","weather","china","global","openweathermap","nws","model-context-protocol","claude","ai-tools","weather-api"],"author":{"name":"chenxming","email":"13716873821@163.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/chenXming/weather-mcp-server.git"},"homepage":"https://github.com/chenXming/weather-mcp-server.git#readme","bugs":{"url":"https://github.com/chenXming/weather-mcp-server.git"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.13.3","zod":"^3.25.71"},"devDependencies":{"@types/node":"^24.0.10","typescript":"^5.8.3"},"peerDependencies":{},"optionalDependencies":{},"_id":"@chenxming/mcp-weather-server@1.0.2","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-san/co+NQffkbvxk1X9hiMUJgkgiJi79qX/wJGMIyFeIWrA/3QpCfTsAp5F+brVg0n30Y4tl2yd20veAEfb6YA==","shasum":"7a2f25a479fe973c82956fc3a41bb7ba6d32b0d3","tarball":"https://registry.npmjs.org/@chenxming/mcp-weather-server/-/mcp-weather-server-1.0.2.tgz","fileCount":4,"unpackedSize":19574,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCZ8ufnlR9hjbdF6Pd2bLBS9rX84g3A3x2ZWc/bTt4uGAIhAMBXBSn0kPl5eshtkcR/qLkxbCte8IjtGMqpJPoTTP7y"}]},"_npmUser":{"name":"chenxming","email":"13716873821@163.com","actor":{"name":"chenxming","email":"13716873821@163.com","type":"user"}},"directories":{},"maintainers":[{"name":"chenxming","email":"13716873821@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-weather-server_1.0.2_1751535191644_0.6921442857473823"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-03T09:11:44.494Z","modified":"2025-07-03T09:33:11.989Z","1.0.0":"2025-07-03T09:11:44.805Z","1.0.1":"2025-07-03T09:13:58.887Z","1.0.2":"2025-07-03T09:33:11.795Z"},"bugs":{"url":"https://github.com/chenXming/weather-mcp-server.git"},"author":{"name":"chenxming","email":"13716873821@163.com"},"license":"MIT","homepage":"https://github.com/chenXming/weather-mcp-server.git#readme","keywords":["mcp","weather","china","global","openweathermap","nws","model-context-protocol","claude","ai-tools","weather-api"],"repository":{"type":"git","url":"git+https://github.com/chenXming/weather-mcp-server.git"},"description":"全球天气MCP服务器，支持中国城市和全球天气查询 - Global Weather MCP Server with support for Chinese cities","maintainers":[{"name":"chenxming","email":"13716873821@163.com"}],"readme":"# 🌤️ MCP Weather Server / 全球天气MCP服务器\n\n[![npm version](https://badge.fury.io/js/%40chenxming%2Fmcp-weather-server.svg)](https://badge.fury.io/js/%40chenxming%2Fmcp-weather-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA powerful Model Context Protocol (MCP) server that provides global weather information with special support for Chinese cities. Perfect for AI assistants like Claude to access real-time weather data.\n\n一个强大的模型上下文协议(MCP)服务器，提供全球天气信息，特别优化了对中国城市的支持。\n\n## ✨ Features / 功能特性\n\n### 🌍 Global Weather Support / 全球天气支持\n- **Current Weather** - Real-time weather for any city worldwide / 全球任意城市的实时天气\n- **5-Day Forecast** - Detailed weather forecasts / 详细的5天天气预报  \n- **Chinese Cities** - Native support for Chinese city names / 原生支持中文城市名称\n- **Multiple Units** - Celsius, Fahrenheit, Kelvin / 摄氏度、华氏度、开尔文\n\n### 🇺🇸 US-Specific Features / 美国专用功能\n- **Weather Alerts** - State-level weather alerts / 州级天气警报\n- **Coordinate Forecasts** - Precise location-based forecasts / 基于坐标的精确预报\n\n## 📦 Installation / 安装\n\n```bash\nnpm install -g @chenxming/mcp-weather-server\n```\n\nOr use without installation:\n```bash\nnpx @chenxming/mcp-weather-server\n```\n\n## 🚀 Quick Start / 快速开始\n\n### 1. Get API Key / 获取API密钥\n\nGet a free API key from [OpenWeatherMap](https://openweathermap.org/api)\n\n在 [OpenWeatherMap](https://openweathermap.org/api) 注册获取免费API密钥\n\n### 2. Configure MCP Client / 配置MCP客户端\n\nAdd to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"weather\": {\n      \"command\": \"npx\",\n      \"args\": [\"@chenxming/mcp-weather-server\"],\n      \"env\": {\n        \"OPENWEATHER_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### 3. Alternative: Local Installation / 本地安装方式\n\n```json\n{\n  \"mcpServers\": {\n    \"weather\": {\n      \"command\": \"mcp-weather\",\n      \"env\": {\n        \"OPENWEATHER_API_KEY\": \"your_api_key_here\"\n      }\n    }\n}\n```\n\n## 🛠️ Available Tools / 可用工具\n\n### 🌐 Global Weather Tools / 全球天气工具\n\n#### `get-current-weather`\nGet current weather for any city worldwide / 获取任意城市的当前天气\n\n**Parameters / 参数:**\n- `city` (required): City name in Chinese or English / 城市名称，支持中英文\n- `country` (optional): Country code like CN, US / 国家代码\n- `units` (optional): Temperature unit / 温度单位\n  - `metric` (default): Celsius / 摄氏度\n  - `imperial`: Fahrenheit / 华氏度  \n  - `kelvin`: Kelvin / 开尔文\n\n**Examples / 示例:**\n- Beijing: `city: \"北京\"` or `city: \"Beijing\", country: \"CN\"`\n- New York: `city: \"New York\", country: \"US\"`\n\n#### `get-weather-forecast`\nGet 5-day weather forecast / 获取5天天气预报\n\n**Parameters / 参数:**\n- `city` (required): City name / 城市名称\n- `country` (optional): Country code / 国家代码\n- `units` (optional): Temperature unit / 温度单位\n\n### 🇺🇸 US-Specific Tools / 美国专用工具\n\n#### `get-alerts`\nGet weather alerts for US states / 获取美国州级天气警报\n\n**Parameters / 参数:**\n- `state` (required): Two-letter state code / 两位字母州代码 (e.g., CA, NY)\n\n#### `get-forecast`\nGet coordinate-based forecast for US locations / 基于坐标的美国地区预报\n\n**Parameters / 参数:**\n- `latitude` (required): Latitude (-90 to 90) / 纬度\n- `longitude` (required): Longitude (-180 to 180) / 经度\n\n## 📝 Usage Examples / 使用示例\n\n### Query Chinese Cities / 查询中国城市\n```json\n{\n  \"tool\": \"get-current-weather\",\n  \"parameters\": {\n    \"city\": \"上海\",\n    \"units\": \"metric\"\n  }\n}\n```\n\n### Query Global Forecast / 查询全球预报\n```json\n{\n  \"tool\": \"get-weather-forecast\", \n  \"parameters\": {\n    \"city\": \"London\",\n    \"country\": \"GB\"\n  }\n}\n```\n\n### US Weather Alerts / 美国天气警报\n```json\n{\n  \"tool\": \"get-alerts\",\n  \"parameters\": {\n    \"state\": \"CA\"\n  }\n}\n```\n\n## 🌏 Supported Cities / 支持的城市\n\n- 🇨🇳 **China**: Beijing, Shanghai, Guangzhou, Shenzhen, Hangzhou, Chengdu...\n- 🇺🇸 **United States**: New York, Los Angeles, Chicago, Houston...  \n- 🌍 **Global**: London, Tokyo, Paris, Sydney, Seoul, Mumbai...\n- ✅ **Chinese & English** city names supported / 支持中英文城市名\n\n## 🔧 Development / 开发\n\n### Local Setup / 本地设置\n```bash\ngit clone https://github.com/chenxming/mcp-weather-server.git\ncd mcp-weather-server\nnpm install\nnpm run build\n```\n\n### Development Mode / 开发模式\n```bash\nnpm run dev  # Watch mode\n```\n\n## 📊 API Data Sources / API数据源\n\n- **Global Weather**: OpenWeatherMap API / 全球天气：OpenWeatherMap API\n- **US Weather**: National Weather Service (NWS) API / 美国天气：国家气象服务API\n\n## ⚡ Requirements / 系统要求\n\n- Node.js >= 18.0.0\n- OpenWeatherMap API key (free) / OpenWeatherMap API密钥（免费）\n\n## 📄 License / 许可证\n\nMIT License - see [LICENSE](LICENSE) file\n\n## 🤝 Contributing / 贡献\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes  \n4. Add tests if applicable\n5. Submit a pull request\n\n## 🐛 Issues / 问题报告\n\nReport issues at: https://github.com/chenxming/mcp-weather-server/issues\n\n## 📞 Support / 支持\n\n- GitHub Issues: Bug reports and feature requests\n- Email: your.email@example.com\n","readmeFilename":"README.md"}