cp .env.example .env
# Edit .env and set NEWS_API_KEY=your_key_here

pip install -e ".[dev]"

uvicorn news_mcp.main:app --reload
# or
news-mcp

{
  "mcpServers": {
    "news": {
      "command": "uvicorn",
      "args": ["news_mcp.main:app", "--port", "8000"],
      "env": {
        "NEWS_API_KEY": "your_key_here"
      }
    }
  }
}

pytest

src/news_mcp/
├── main.py          # App factory, MCP mount
├── config.py        # pydantic-settings config
├── models/
│   └── schemas.py   # All Pydantic request/response models
├── services/
│   └── news_service.py  # NewsAPI HTTP logic
└── routes/
    ├── headlines.py
    ├── search.py
    ├── trending.py
    └── sources.py
tests/
├── conftest.py
├── test_headlines.py
├── test_search.py
├── test_trending.py
└── test_sources.py