Repository avatar
AI Tools
v0.2.0
active

ai-news-mcp

io.github.duncan-wen/ai-news-mcp

Collects AI news from many Sources into a local store for Claude to query. No API key.

Documentation

AI News MCP

繁體中文

An MCP server that collects AI news from 23 Sources (company blogs, tech news sites, engineering blogs, release pages, Hacker News, Product Hunt, Hugging Face and OpenRouter) into a local store, and lets Claude ask what's new, search it, and read the full text of an Item.

It runs on your machine. It needs no API key, no scheduler and no cloud service, and it never calls an LLM: Claude does the summarising when you ask. It works in any MCP client (Claude Code, Claude Desktop, Cursor, VS Code and others) with the model that client uses; these docs say Claude because Claude is what it is tested with.

Is it for you? Use it if you want Claude to brief you on AI news without you visiting a dozen sites, and you are fine with Claude reading the titles and summaries of Items from public Sources. It is not a news reader with its own interface, it does not summarise Items or merge Items about the same event itself, and it only knows what its Sources publish.

What it does

  • What's New: everything collected since you last asked, per Category, that was published in the last 7 days.
  • Search: by text, publish time, Category and Source, over everything collected so far (history is kept, so "last week" works).
  • Full text: fetches an Item's original page and extracts the main text when the summary is not enough.
  • Collection on demand: when the data is over 24 hours old, the server collects by itself when it starts or when you ask what's new. The first collection reaches back 30 days.
  • Source health: lists every Source with its last error, and warns when a Source fails 3 collections in a row.

Example

Ask Claude things like:

  • "What's new in AI?"
  • "Anything new in Models? Group the Items about the same model."
  • "Find last week's Engineering Items about MCP."
  • "Read the full text of the second one and summarise it."
  • "Which news Sources are failing?"

Claude calls whats_new for the first two, search for the third, read_item for the fourth and list_sources for the last, then writes the answer from the Items it gets back.

Install

You need uv and an MCP client. With Claude Code:

claude mcp add --scope user ai-news -- uvx ai-news-mcp

That is all: uvx downloads and runs the package, and --scope user makes it available in every project. Start a new Claude Code session and ask "What's new in AI?". The first answer can take about a minute while the server collects.

To run it from a clone instead:

git clone https://github.com/duncan-wen/ai-news-mcp.git
claude mcp add --scope user ai-news -- uv run --directory /path/to/ai-news-mcp ai-news-mcp

Claude Desktop

Add it to claude_desktop_config.json (Settings > Developer > Edit Config; ~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows), then restart Claude Desktop:

{
  "mcpServers": {
    "ai-news": {
      "command": "uvx",
      "args": ["ai-news-mcp"]
    }
  }
}

Cursor

Add it to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project:

{
  "mcpServers": {
    "ai-news": {
      "type": "stdio",
      "command": "uvx",
      "args": ["ai-news-mcp"]
    }
  }
}

VS Code

Run MCP: Open User Configuration from the Command Palette and add it under servers (or put it in .vscode/mcp.json for one workspace). Its tools are then available in Chat in agent mode:

{
  "servers": {
    "ai-news": {
      "type": "stdio",
      "command": "uvx",
      "args": ["ai-news-mcp"]
    }
  }
}

Other MCP clients

Every client starts it the same way: the command is uvx ai-news-mcp, over stdio, with no arguments, environment variables or API key; from a clone, it is uv run --directory /path/to/ai-news-mcp ai-news-mcp. If a client cannot find uvx, give its full path as the command (the output of which uvx, or where uvx on Windows).

Tools

ToolWhat it does
whats_newItems collected since the last Checkpoint of each Category asked about (all if none) and published in the last 7 days, about 100 at most. Moves those Checkpoints to now.
searchItems by text, since / until, Categories and Source ids; newest first. summary_length (default 500) shortens the summaries shown (0: none). Never moves a Checkpoint.
read_itemThe main text of an Item's original page, cut to max_length characters (default 10,000); truncated and full_length say whether it was cut and how long the whole text is, so a client can ask again with a larger max_length.
list_sourcesEvery Source with its URL, default Categories and collection state.
collect_nowCollects from every Source now and reports what each added or why it failed.

Categories

Every Item has one or more Categories. A Source gives its default Categories, and keyword rules on the title and summary add others (for example, an Item from a News Source that names a new model is also in Models).

CategoryDefinition
NewsEvents in the AI industry, such as launches, funding, policy, and people changes.
ApplicationsNew AI products or tools that you can use right away.
EngineeringContent about how to build AI systems, such as technical posts, frameworks, lessons from practice, and releases.
ModelsNewly released or newly listed AI models, and changes to what they can do and what they cost. Academic papers and theory are not included.

Each Category has its own Checkpoint, so asking only about Models does not mark the day's News as seen.

What's New shows each Item once: ask again and it is empty until the next collection brings new Items. To see recent Items again, ask by time instead ("What was published this week?"): Claude then calls search, which never moves a Checkpoint. Claude calls whats_new only when you ask what is new since you last looked; a question with a time span ("today", "recently") or a subject goes to search, so it never marks Items as seen by accident. Every client of the server (Claude Code, Claude Desktop, the MCP Inspector) shares one store and one set of Checkpoints, so calling whats_new from the Inspector while testing also marks those Items as seen for Claude.

The terms used here are defined in GLOSSARY.md.

Sources

Source idNameDefault Categories
openai-newsOpenAI NewsNews
google-deepmindGoogle DeepMind BlogNews
google-aiGoogle AI (The Keyword)News
anthropic-newsAnthropic NewsNews
mistral-newsMistral NewsNews
microsoft-aiMicrosoft Source: AINews
techcrunch-aiTechCrunch AINews
the-verge-aiThe Verge AINews
mit-technology-review-aiMIT Technology Review AINews
simon-willisonSimon WillisonEngineering
latent-spaceLatent SpaceEngineering
langchain-blogLangChain BlogEngineering
vercel-blogVercel BlogEngineering
cloudflare-blogCloudflare BlogEngineering
hugging-face-blogHugging Face BlogEngineering
nvidia-blogNVIDIA BlogEngineering
aws-machine-learningAWS Machine Learning BlogEngineering
vllm-releasesvLLM releasesEngineering
transformers-releasesTransformers releasesEngineering
hacker-news-aiHacker News: AI (stories with 100+ points whose title is about AI)Applications
product-hunt-aiProduct Hunt: AIApplications
hugging-face-modelsHugging Face: trending modelsModels
openrouter-modelsOpenRouter: new modelsModels

Source config file

To add your own Sources, disable built-in ones or change their fields, create sources.toml in your config directory. The server runs fine without it.

PlatformLocation
Linux, WSL~/.config/ai-news-mcp/sources.toml (or $XDG_CONFIG_HOME/ai-news-mcp/)
macOS~/Library/Application Support/ai-news-mcp/sources.toml
Windows%LOCALAPPDATA%\ai-news-mcp\sources.toml
disabled = ["techcrunch-ai"]          # built-in Source ids not to collect

[sources.my-blog]                     # a new Source: name, url and default_categories
name = "My Blog"
url = "https://example.com/feed.xml"  # RSS or Atom
default_categories = ["Engineering"]  # any of News, Applications, Engineering, Models

[sources.openai-news]                 # a built-in Source id: only the fields given change
url = "https://openai.com/news/rss.xml"
  • A new Source needs name, url and default_categories. Its kind defaults to rss (RSS or Atom); the other kinds are those of the built-in Sources (anthropic-sitemap, hn-algolia, hf-models, openrouter-models).
  • A table named after a built-in Source changes only the fields it gives (name, url, default_categories, kind).
  • If the file is malformed (an unknown key or Category, a disabled id that is no built-in Source), the server does not start, and its error says what to fix. Restart the server (start a new Claude Code session) after editing it.

Collected Items are stored in a SQLite file in your data directory (~/.local/share/ai-news-mcp/store.sqlite3 on Linux). Deleting it starts over with a fresh 30-day collection.

Design decisions

Each decision has an Architecture Decision Record in docs/adr/:

Terms of use

This project does not run any service: the server on your machine fetches each Source directly, identifying itself with a User-Agent that links to this repository, and spaces out its requests to each host. You are responsible for following each Source's terms of use. The store stays on your machine; Claude sees only the Items its tools return.

Development

uv sync
scripts/check   # lint, format, types, workflows, tests and the package build, as CI runs them
scripts/fix     # apply the formatter and lint autofixes
uv build        # build the sdist and wheel into dist/

How to report issues and propose changes is in CONTRIBUTING.md; changes per release are in CHANGELOG.md. Source URLs, rate limits and quirks are in docs/research/ai-news-sources.md. Coding standards are in CODING_STANDARDS.md.

License

MIT

PYPI
ai-news-mcp
Install Command
pip install ai-news-mcp
Runtime: uvx