Python MCP Server

🚀 MCP Server

Python version of the Weather MCP Server.

Documentation

Python SDK

🚀 Quick Start

Installation Steps

# Create a new project directory
uv init

# Create and activate a virtual environment
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx

📚 Documentation

Testing

This project includes a comprehensive test suite for testing the weather service API. These tests use pytest and pytest-asyncio to test asynchronous functions interacting with the National Weather Service API.

Test Requirements

• Python version 3.12+
• pytest
• pytest-asyncio
• pytest-cov
• httpx

Install Development Dependencies

You can install all development dependencies using the following commands:

# Use uv
uv pip install -e ".[dev]"

# Or use pip
pip install -e ".[dev]"

Run Tests

To run the tests, perform the following operations:

# Run all tests
pytest

# Run tests in verbose output mode
pytest -v

# Run tests in code coverage mode
pytest --cov=weather

Test Coverage

The test suite covers the following aspects:

1. Unit tests for helper functions

   • The format_alert function for formatting alert data
   • Error handling in make_nws_request

2. API function tests

   • get_alerts: Test successful retrieval, empty results, and API failure scenarios
   • get_forecast: Test successful forecast retrieval and its error handling for two API endpoints

3. Mocked responses

   • All HTTP requests are mocked using httpx.AsyncMock
   • Multiple test scenarios with different API responses

Continuous Integration

When adding new features to the weather service, ensure that all tests pass before submitting changes.