SIP News MCP

An MCP connector that lets an AI assistant search and read the official news of the Luxembourg government press service (Service information et presse, SIP) at sip.gouvernement.lu.

It exposes the full SIP news archive (press releases, communiqués, speeches, state visits, ministerial news, back to ~2012) as clean, structured, full-text-searchable data, in German, French or English.

Why it exists

The SIP news page loads its list through a JavaScript component, so a naive HTTP fetch returns an empty shell. This connector instead uses the site's own RSS endpoints, which return clean, paginated, newest-first data:

Each page returns 50 items as a sliding window over the whole archive. The connector pages through automatically, de-duplicates, decodes the (double-encoded) entities, recovers each item's category/language/date from its URL, and can fetch the full article body on demand.

Related MCP server: News Analysis Agent MCP Server

Tools

Common parameters:

• language — de, fr or en (interface language; many items are in French regardless, so try more than one if needed).

• limit — how many results to return; larger values page deeper into history.

• since / until — YYYY-MM-DD date bounds.

• category — e.g. communiques (press releases), articles, discours (speeches); see list_categories.

Returned fields per item: title, summary, url, published (ISO), published_human, category, category_label, content_language, source.

search_news / browse_latest_news also return count, complete and an optional note. complete: false means the scan stopped at the page cap or time budget rather than covering the whole archive/range, so a short or empty list there is not an authoritative "nothing exists" (the note explains how to narrow the query). get_article returns the body and a truncated flag.

Semantic search

semantic_search matches news by meaning rather than exact keywords, so it answers natural-language questions ("military cooperation with Belgium", "attacks on state IT systems") even when the wording differs from the article.

How it works:

• build_semantic_index pages through the archive, embeds each item (title + summary) with an OpenRouter embedding model, and stores the vectors in a local ChromaDB collection. Documents are embedded as passage and queries as query (asymmetric retrieval), which sharply improves ranking.

• semantic_search embeds the question and returns the nearest items by cosine similarity, with the same language / category / since / until filters. Each result carries a similarity score in [0, 1].

Setup:

1. Get an OpenRouter API key and put it in the server's environment as OPENROUTER_API_KEY (see the config below). The default model nvidia/llama-nemotron-embed-vl-1b-v2:free is free.

2. Build the index once (from Claude, call build_semantic_index, or run the one-liner below). A full build covers ~2000 items (the whole archive back to ~2004) in under a minute. Re-run it periodically to pick up new news.

uv run python -c "import asyncio; from sip_news_mcp.semantic import SemanticIndex; print(asyncio.run(SemanticIndex().build(language='fr', max_items=2000)))"

Relevant environment variables (all optional except the key):

See .env.example.

Requirements

• uv (recommended), or Python 3.10+ with pip.

uv will download a suitable Python automatically; you do not need one installed system-wide.

Note (Windows + network drives). If you keep this project on a network / UNC drive, Python's Windows extensions (pywin32, pulled in by mcp) cannot load their DLLs from a UNC path, so the virtual environment must sit on a local disk. Point UV_PROJECT_ENVIRONMENT at a local folder (the project code can stay on the network drive; only the installed environment needs to be local). The commands and MCP config below set it.

Quick start

cd C:\path\to\SIP-MCP-Connector
$env:UV_PROJECT_ENVIRONMENT = "$env:LOCALAPPDATA\sip-news-mcp\venv"
uv sync --extra dev     # create the LOCAL environment and install dependencies
uv run pytest           # run the offline test suite (uses captured fixtures)
uv run sip-news-mcp     # start the server (stdio); Ctrl-C to stop

A quick live check without an MCP client (run in the same shell, so it reuses the local environment set above):

uv run python -c "import asyncio; from sip_news_mcp.client import SipNewsClient; print(asyncio.run(SipNewsClient().search('cyber', language='de', limit=3)))"

Use it from Claude

Claude Desktop

Add this to claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json on Windows), then restart Claude Desktop. See examples/claude_desktop_config.json:

{
  "mcpServers": {
    "sip-news": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\SIP-MCP-Connector", "run", "sip-news-mcp"],
      "env": {
        "UV_PROJECT_ENVIRONMENT": "C:\\sip-news-mcp\\venv",
        "OPENROUTER_API_KEY": "sk-or-v1-...your key...",
        "SIP_NEWS_CHROMA_DIR": "C:\\sip-news-mcp\\chroma"
      }
    }
  }
}

(OPENROUTER_API_KEY / SIP_NEWS_CHROMA_DIR are only needed for semantic search. If Claude Desktop cannot find uv, use the absolute path to uv.exe instead, since it may not inherit your shell PATH.)

Claude Code (CLI)

claude mcp add sip-news `
  --env UV_PROJECT_ENVIRONMENT="$env:LOCALAPPDATA\sip-news-mcp\venv" `
  --env OPENROUTER_API_KEY="sk-or-v1-...your key..." `
  -- uv --directory "C:\path\to\SIP-MCP-Connector" run sip-news-mcp

Example prompts

• "Search SIP for news about cybersécurité in 2025 and summarise the top 5."

• "List all SIP press releases (communiques) since 2026-01-01."

• "Find SIP articles mentioning armée and open the most recent one in full."

Notes and limits

• Search uses the SIP site's own full-text engine, which is a broad match: a hit may mention the term only in its body, and ranking is the site's, not ours. The connector returns those results faithfully. Use get_article to confirm relevance before quoting.

• Content language varies per item; the connector reports content_language per result so you can tell French items from German ones.

• Date filtering is most efficient for recent ranges (the feed is newest-first and stops early once it passes since); very old ranges page deeper and may hit the page cap or the ~45s time budget, in which case the result is marked complete: false with an explanatory note.

• Identical requests are cached in-process for 5 minutes (bounded LRU), so repeating the same query does not re-hit the server. A single search/browse call still issues up to ~40 sequential page requests, but they are made one at a time (each awaited before the next) under a descriptive User-Agent, which keeps load on the public government server modest.

• get_article only fetches https URLs on sip.gouvernement.lu (host is parsed and checked, not substring-matched), so it cannot be turned into a request to other hosts.

• This connector only reads public pages; it performs no writes and needs no credentials.

Deployment (Docker / Kubernetes)

The server speaks two transports, chosen by MCP_TRANSPORT:

• stdio (default) for Claude Desktop / Code (local subprocess).

• http (streamable-http) for containers and Kubernetes, listening on MCP_HOST:MCP_PORT (default 0.0.0.0:8000, path /mcp).

It also supports two vector backends via SIP_NEWS_VECTOR_BACKEND:

• chroma (embedded, default) for local use.

• qdrant (a shared, network Qdrant) for containers / multiple replicas, set with QDRANT_URL (and optional QDRANT_API_KEY).

Docker Compose

Brings up Qdrant + the MCP server (HTTP) together:

echo "OPENROUTER_API_KEY=sk-or-v1-...your key..." > .env
docker compose up -d --build
docker compose run --rm index-build      # populate the vector index once
# MCP server: http://localhost:8000/mcp   (streamable-http)

Docker (image only)

docker build -t sip-news-mcp:latest .
docker run --rm -p 8000:8000 \
  -e OPENROUTER_API_KEY=sk-or-v1-... \
  -e SIP_NEWS_VECTOR_BACKEND=qdrant -e QDRANT_URL=http://host.docker.internal:6333 \
  sip-news-mcp:latest

Kubernetes (Helm)

The chart in deploy/helm/sip-news-mcp deploys the server, a bundled Qdrant (StatefulSet + PVC), a Secret for the API key, and an optional one-shot Job that builds the index after install.

helm install sip-news deploy/helm/sip-news-mcp \
  --set openrouter.apiKey=sk-or-v1-...your key...
# or reference an existing Secret:  --set openrouter.existingSecret=my-secret

Key values (see values.yaml):

Reach it with kubectl port-forward svc/sip-news-... 8000:8000, then point an MCP client at http://localhost:8000/mcp.

Connecting an MCP client over HTTP

Claude Desktop's config is stdio-only; to use the HTTP server, configure an MCP client that supports the streamable-http transport with URL http://<host>:8000/mcp.

Project layout

src/sip_news_mcp/
  client.py       HTTP client, RSS/article parsers, filtering, pagination
  semantic.py     OpenRouter embeddings + the SemanticIndex
  vectorstore.py  pluggable vector backends (ChromaDB / Qdrant)
  build_index.py  `sip-news-index` CLI (one-shot index build, used by jobs)
  server.py       FastMCP server, tool definitions, stdio/http transport
  __main__.py     `python -m sip_news_mcp`
tests/
  test_client.py    offline tests for the keyword/HTTP layer
  test_semantic.py  offline tests for the vector layer (fake embedder)
  fixtures/         captured live responses
Dockerfile          container image (HTTP transport)
docker-compose.yml  Qdrant + MCP server + one-shot index build
deploy/helm/sip-news-mcp/   Kubernetes Helm chart
examples/
  claude_desktop_config.json