{"_id":"@abhishekkumar00019/weather_mcp","name":"@abhishekkumar00019/weather_mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@abhishekkumar00019/weather_mcp","version":"1.0.0","description":"A Model Context Protocol (MCP) server providing weather forecasts using the free Open-Meteo API","type":"module","main":"dist/index.js","bin":{"weather-mcp-server":"dist/index.js"},"scripts":{"build":"tsup","dev":"tsup --watch","start":"node dist/index.js"},"keywords":["mcp","model-context-protocol","weather","open-meteo","claude"],"author":"","license":"ISC","dependencies":{"@modelcontextprotocol/sdk":"^1.0.1","axios":"^1.6.8","zod":"^3.22.4"},"devDependencies":{"@types/node":"^20.11.30","tsup":"^8.0.2","typescript":"^5.4.3"},"_id":"@abhishekkumar00019/weather_mcp@1.0.0","gitHead":"3a166d55a826cb81f6d98f048712acf3ca260c92","types":"./dist/index.d.ts","_nodeVersion":"24.11.1","_npmVersion":"10.6.0","dist":{"integrity":"sha512-4ammvIZuX7vfmd6ZsP9jnV8p1hPKFCN6i5jGmXrOlKlzhQB6qVY5+AmayVq21qTH9Dlix0zZsVxLiscR//1qZw==","shasum":"aa006d8aee8bcc98aae3b4740aaea8fa12e35c7d","tarball":"https://registry.npmjs.org/@abhishekkumar00019/weather_mcp/-/weather_mcp-1.0.0.tgz","fileCount":4,"unpackedSize":10831,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCvvpecW3JGFAfYN+oBYMs3379f5KYTAx06J2tylddrgAIhAOxXZtYBFnquknVXiKO+XGEPx//zWrPcm9TB0mPVZs1a"}]},"_npmUser":{"name":"abhishekkumar00019","email":"itachi0uchiha19@gmail.com"},"directories":{},"maintainers":[{"name":"abhishekkumar00019","email":"itachi0uchiha19@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/weather_mcp_1.0.0_1784360153061_0.33097606125911927"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-18T07:35:52.904Z","1.0.0":"2026-07-18T07:35:53.181Z","modified":"2026-07-18T07:35:53.471Z"},"maintainers":[{"name":"abhishekkumar00019","email":"itachi0uchiha19@gmail.com"}],"description":"A Model Context Protocol (MCP) server providing weather forecasts using the free Open-Meteo API","keywords":["mcp","model-context-protocol","weather","open-meteo","claude"],"license":"ISC","readme":"# Weather MCP Server\n\nA Model Context Protocol (MCP) server that provides weather forecasts and geocoding lookup using the free, keyless Open-Meteo APIs. This server enables LLMs (like Claude, Gemini, and GPT) to query real-time weather information and multi-day forecasts for any city or location in the world.\n\n## Features\n\n- **Get Current Weather:** Detailed current conditions including condition description, temperature, apparent temperature (feels like), humidity, wind speed, and precipitation details.\n- **Multi-day Weather Forecast:** Standard 1-7 day forecast with conditions, daily min/max temperatures, and total expected precipitation.\n- **Keyless & Free:** Powered by the open-source [Open-Meteo](https://open-meteo.com/) APIs, requiring no API keys or subscription signups.\n- **Fuzzy Geocoding:** Automatically resolves location names (e.g., \"Paris\", \"New York\", \"London\") to geographic coordinates and timezones.\n\n---\n\n## Installation & Usage\n\nYou can run this server directly from npm using `npx`, or install it globally.\n\n### Method 1: Using `npx` (Recommended)\n\nTo run the server without installation:\n\n```bash\nnpx -y weather-mcp-server\n```\n\n### Method 2: Global Installation\n\nInstall the package globally:\n\n```bash\nnpm install -g weather-mcp-server\n```\n\nThen run it:\n\n```bash\nweather-mcp-server\n```\n\n---\n\n## Configuration for MCP Clients\n\n### 1. Claude Desktop\n\nTo add the Weather MCP Server to Claude Desktop, edit your `claude_desktop_config.json` file.\n\n- **Windows path:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **macOS path:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n\nAdd the server to the `mcpServers` list:\n\n```json\n{\n  \"mcpServers\": {\n    \"weather\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"weather-mcp-server\"\n      ]\n    }\n  }\n}\n```\n\n### 2. Cursor\n\nCursor supports custom MCP servers directly from the GUI:\n\n1. Open **Cursor Settings** (`Ctrl + ,` or `Cmd + ,`).\n2. Go to **Features** -> **MCP**.\n3. Click **+ Add New MCP Server**.\n4. Fill in:\n   - **Name:** `Weather`\n   - **Type:** `command`\n   - **Command:** `npx -y weather-mcp-server`\n5. Click **Save**.\n\n---\n\n## Tool Documentation\n\nThis server exposes a single tool called `get_weather`.\n\n### `get_weather`\n\nGets the current weather and daily forecast for a given location.\n\n**Arguments:**\n- `location` (string, required): The city, region, or location name (e.g. `\"Tokyo\"`, `\"Paris\"`, `\"Chicago, IL\"`).\n- `days` (number, optional, default: `3`): Number of forecast days to return (integer between `1` and `7`).\n\n**Example Request:**\n```json\n{\n  \"name\": \"get_weather\",\n  \"arguments\": {\n    \"location\": \"Paris\",\n    \"days\": 3\n  }\n}\n```\n\n---\n\n## Development & Building\n\nIf you want to run the server locally from the source code, follow these steps:\n\n1. Clone or download the repository.\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n3. Build the TypeScript code:\n   ```bash\n   npm run build\n   ```\n4. Run locally:\n   ```bash\n   npm start\n   ```\n\nTo link and test the local version in Claude Desktop, point the configuration directly to the local path:\n\n```json\n{\n  \"mcpServers\": {\n    \"weather-local\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"C:/path/to/your/project/dist/index.js\"\n      ]\n    }\n  }\n}\n```\n\n## License\n\nISC License. Feel free to use and adapt this server.\n","readmeFilename":"README.md","_rev":"1-dc7471828fe807a777078c9866152d59"}