global-news-intelligence-mcp

RSS Fetch → Parse → Classify → Rank by Importance → Summarize → JSON Response

git clone https://github.com/ashtondebug/global-news-intelligence-mcp.git
cd global-news-intelligence-mcp

python -m venv .venv
source .venv/bin/activate   # macOS/Linux
# .venv\Scripts\activate    # Windows

pip install -e .
cp config.example.yaml config.yaml

python check_env.py

Global News Intelligence MCP - Environment Check

  Python 3.12.13: OK
  fastmcp: OK      httpx: OK      feedparser: OK
  pyyaml: OK       pydantic: OK

Result: ALL CHECKS PASSED

python -m global_news_mcp

[
  {
    "title": "OpenAI Announces GPT-5",
    "source": "TechCrunch",
    "time": "2026-08-04T10:30:00+00:00",
    "summary": "OpenAI has officially announced GPT-5, their next-generation...",
    "url": "https://techcrunch.com/2026/08/04/...",
    "category": "ai"
  }
]

network:
  timeout: 15
  proxy:
    enabled: false       # Set to true for mainland China
    http: ""             # e.g. http://127.0.0.1:7890  (Clash)
    https: ""            # e.g. http://127.0.0.1:7890

cache:
  ttl: 900              # Seconds (15 min)

logging:
  level: "INFO"
  file: ""              # Empty = stderr only

sources:
  technology: true       # Toggle individual categories
  ai: true
  # ... 12 categories total

┌──────────────────────────────────────┐
│           MCP Client (LLM)            │
│   XiaoZhi AI / Claude / Codex / ...   │
└──────────────────┬───────────────────┘
                   │ stdio (JSON-RPC)
┌──────────────────▼───────────────────┐
│          main.py (FastMCP)            │
│         16 registered tools           │
└──┬───────┬──────┬───────┬────────────┘
   │       │      │       │
   ▼       ▼      ▼       ▼
┌──────┐ ┌────┐ ┌──────┐ ┌──────────┐
│ rss  │ │cache│ │ranking│ │summarizer│
│ .py  │ │ .py │ │ .py  │ │   .py    │
└──┬───┘ └──┬─┘ └──┬───┘ └────┬─────┘
   │        │      │          │
   ▼        ▼      ▼          ▼
┌──────┐ ┌──────┐ ┌──────┐ ┌──────────┐
│parser│ │SQLite│ │sources│ │classifier│
│ .py  │ │  DB  │ │ .py  │ │   .py    │
└──────┘ └──────┘ └──────┘ └──────────┘

{"name": "My Source", "url": "https://example.com/rss", "category": "technology"},

{
  "mcpServers": {
    "global_news": {
      "command": "python",
      "args": ["-m", "global_news_mcp"],
      "cwd": "/path/to/global-news-intelligence-mcp"
    }
  }
}

pip install -e ".[dev]"
pytest

@mcp.tool()
async def get_my_category_news() -> str:
    """Get news for my custom category."""
    return await _fetch_news(["my_category"], 10)

.
├── pyproject.toml
├── config.example.yaml
├── README.md
├── RUNBOOK.md
├── check_env.py
├── install.bat
├── start.bat
├── src/global_news_mcp/
│   ├── main.py          # Entry point + 16 tool registrations
│   ├── sources.py       # 28 RSS feed definitions
│   ├── rss.py           # Async concurrent fetching
│   ├── parser.py        # feedparser → Article model
│   ├── classifier.py    # Keyword-based classification
│   ├── ranking.py       # Importance scoring
│   ├── summarizer.py    # Response formatting
│   ├── cache.py         # SQLite cache layer
│   ├── network.py       # httpx client (proxy/timeout)
│   ├── config.py        # YAML config loader
│   └── logger.py        # stderr logging
└── .gitignore