News MCP

- Do not begin coding unless the user asks you to. If the user is asking a question about the code, answer the question - do not write or modify code unless explicitly asked.

The server exposes news articles stored in a database via a resource URI:

- news://{category}/{limit}: Retrieves a list of the latest articles for a given category.

- {category}: Filters articles by category (e.g.,tech,data_science,news). See tool description for full list.
- {limit}(optional, default 10): Specifies the maximum number of articles to return.

The server currently does not expose any prompts. (The summarization logic exists internally but is not available via an MCP prompt).

- summarize_news: Retrieves raw news articles from the database, allowing the client (LLM) to summarize them.

- Takes optionalcategory(string) andlimit(integer, default 20) arguments.
- Returns a list of article dictionaries, each containingid,title,link,published,source, andcontent.
- Available categories:tech,data_science,llm_tools,cybersecurity,linux,audio_dsp,startups,news,science,research,policy.

The server relies on a PostgreSQL database configured via theDATABASE_URLenvironment variable (defaults topostgresql://localhost/mcp_news).

Thenews_gatherer.pyscript (intended to be run separately/scheduled) populates the database from various RSS feeds.

Summarization logic (internal, not exposed via MCP) uses the OpenAI API, configured via theOPENAI_API_KEYenvironment variable.

Other configurations (via environment variables or defaults):

- LOOKBACK_HOURS: How far backnews_gatherer.pylooks for new articles (default: 6).
- SUMMARY_WORD_TARGET: Target word count for internal summarization (default: 500).
- MAX_ARTICLES_PER_SUMMARY: Maximum articles included in one summary batch (default: 25).
- KEYWORD_FILTER: Keywords used by internal summarization logic.

On MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.jsonOn Windows:%APPDATA%/Claude/claude_desktop_config.json

To prepare the package for distribution:

This will create source and wheel distributions in thedist/directory.

Note: You'll need to set PyPI credentials via environment variables or command flags:

- Token:--tokenorUV_PUBLISH_TOKEN
- Or username/password:--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using theMCP Inspector.

You can launch the MCP Inspector vianpmwith this command:

npx @modelcontextprotocol/inspector uv --directory ~/dev/news-mcp run news-mcp

NewTqnia MCP Server provides AI assistants with real-time access to independent bilingual technology news. Search and retrieve the latest articles, headlines, categories, and structured tech coverage in English and Arabic through the Model Context Protocol (MCP).