{
  "markdown": "# Weather MCP Server\n\nAn MCP server that provides:\n\n* Active US National Weather Service (NWS) alerts by two-letter state code\n* Short-term point forecasts (next 5 periods) for latitude/longitude coordinates\n\nData is sourced from the public NWS API at https://api.weather.gov.\n\n## Tools\n\n| Tool | Description | Inputs |\n|------|-------------|--------|\n| `get_alerts` | Fetch active NWS alerts for a US state | `state` (string, two-letter code) |\n| `get_forecast` | Fetch short-term forecast (next 5 periods) for coordinates | `latitude` (number), `longitude` (number) |\n\n## Usage (Local)\n\nInstall dependencies:\n\n```powershell\npip install .\n```\n\nRun the MCP server (stdio transport):\n\n```powershell\npython -m weather.weather\n```\n\nYour MCP client should be configured to launch the server via the package entrypoint or the above module path.\n\n## Server JSON Summary\n\nSee `server.json` for registry metadata including name, version, tools, and entrypoint configuration.\n\n## Publishing Steps (Overview)\n\n1. Authenticate with publisher (GitHub namespace):\n\t```powershell\n\tmcp-publisher login github\n\t```\n2. Create and push repo to GitHub (see steps below).\n3. (Optional) Publish to PyPI if distributing as a package.\n4. Publish to MCP registry:\n\t```powershell\n\tmcp-publisher publish\n\t```\n5. Verify:\n\t```powershell\n\tcurl \"https://registry.modelcontextprotocol.io/v0/servers?search=io.github.vtiwari/weather-mcp\"\n\t```\n\n## Create & Push GitHub Repository\n\nIf this directory is not yet a git repo:\n\n```powershell\ngit init\ngit add .\ngit commit -m \"Initial commit: Weather MCP server\"\n```\n\nCreate repo (GitHub CLI) and push:\n\n```powershell\ngh repo create vtiwari/weather-mcp --public --source . --remote origin --push\n```\n\nIf not using GitHub CLI, create the repo manually via the GitHub web UI, then:\n\n```powershell\ngit remote add origin https://github.com/vtiwari/weather-mcp.git\ngit branch -M main\ngit push -u origin main\n```\n\nTag version for release consistency:\n\n```powershell\ngit tag v0.1.0\ngit push origin v0.1.0\n```\n\n## PyPI Packaging (Optional)\n\nTo distribute via PyPI, ensure `pyproject.toml` includes build backend and metadata (authors, license). Then:\n\n```powershell\npip install build twine\npython -m build\ntwine upload dist/*\n```\n\n## License\n\nMIT (adjust if different).\n\n## Disclaimer\n\nThis server uses public NOAA/NWS endpoints. Respect API usage guidelines and rate limits.\n\n",
  "bytes": 2380,
  "sha": "bda15becbf6f2dfd4c09104c28fc31e52f1c0b5e4e28411e65d50cee94169b16",
  "repo_slug": "rsys-vtiwari/weather-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rsys_vtiwari_weather_mcp_39830a76/readme"
}