axians-mcp 0.1.0

MCP server providing tools for weather and more

Axians MCP Server A Model Context Protocol (MCP) server that provides weather information tools using the National Weather Service API.

Features 🌦️ Weather Alerts: Get active weather alerts for any US state 📊 Weather Forecast: Get detailed weather forecasts for any location (latitude/longitude) 🚀 FastMCP Framework: Built on the efficient FastMCP framework 🔧 Multiple Transports: Supports stdio, SSE, and streamable HTTP transports Installation Using uvx (Recommended) bash uvx axians-mcp --transport=stdio Using pip bash pip install axians-mcp axians-mcp --transport=stdio Development Installation bash git clone cd axians-mcp uv pip install -e . Usage Basic Usage bash

Start the MCP server with stdio transport

axians-mcp --transport=stdio

Start with verbose logging

axians-mcp --verbose --transport=stdio

Start with custom environment file

axians-mcp --env-file=.env.custom --transport=stdio Available Transports stdio: Standard input/output (default, recommended for MCP clients) sse: Server-Sent Events streamable-http: HTTP streaming Environment Configuration Create a .env file in your project directory:

env TRANSPORT=stdio LOG_LEVEL=INFO Tools Available Weather Alerts Get active weather alerts for a US state:

python

Example usage in MCP client

await call_tool("get_alerts", {"state": "CA"}) Parameters:

state (string): Two-letter US state code (e.g., "CA", "NY", "TX") Weather Forecast Get detailed weather forecast for a specific location:

python

Example usage in MCP client

await call_tool("get_forecast", { "latitude": 37.7749, "longitude": -122.4194 }) Parameters:

latitude (float): Latitude coordinate longitude (float): Longitude coordinate Command Line Options Usage: axians-mcp [OPTIONS]

Options: -v, --verbose Increase verbosity (can be used multiple times) --env-file PATH Path to .env file --transport [stdio|sse|streamable-http] Transport type (default: stdio) --help Show this message and exit Examples Getting Weather Alerts for California bash

Start the server

axians-mcp --transport=stdio

In your MCP client, call:

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_alerts", "arguments": { "state": "CA" } } } Getting Forecast for San Francisco bash

In your MCP client, call:

{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "get_forecast", "arguments": { "latitude": 37.7749, "longitude": -122.4194 } } } Integration with MCP Clients This server is compatible with any MCP client, including:

Claude Desktop: Add to your MCP configuration Custom Applications: Use the MCP protocol to integrate weather data Development Tools: Great for testing and development workflows Claude Desktop Configuration Add to your MCP settings:

json { "mcpServers": { "axians-weather": { "command": "uvx", "args": ["axians-mcp", "--transport=stdio"] } } } API Data Source This server uses the National Weather Service (NWS) API, which provides:

Real-time weather alerts Detailed forecasts High-quality, government-sourced weather data Free access (no API key required) All data is sourced from https://api.weather.gov and follows NWS API guidelines.

Development Project Structure src/axians_mcp/ ├── init.py # CLI entry point and main configuration ├── servers/ │ ├── init.py # Server exports │ ├── main.py # FastMCP server setup │ └── weather.py # Weather tools implementation Running Tests bash

Install development dependencies

uv pip install -e ".[dev]"

Run tests (when available)

pytest Building the Package bash uv run python -m build Contributing Fork the repository Create a feature branch (git checkout -b feature/amazing-feature) Commit your changes (git commit -m 'Add amazing feature') Push to the branch (git push origin feature/amazing-feature) Open a Pull Request Requirements Python 3.10+ Internet connection (for NWS API access) Dependencies fastmcp>=2.3.4: FastMCP framework httpx>=0.28.0: HTTP client for API requests click>=8.1.7: Command-line interface python-dotenv>=1.0.1: Environment variable management pydantic>=2.10.6: Data validation License This project is licensed under the MIT License - see the LICENSE file for details.

Support For issues and questions:

Check the Issues page Create a new issue with detailed information Include logs and configuration details Changelog v0.1.0 Initial release Weather alerts tool Weather forecast tool Multiple transport support FastMCP integration