News MCP Server

A Model Context Protocol (MCP) server that aggregates news from multiple sources:

Hacker News (top, best, new stories)
RSS Feeds (configurable)
Twitter (planned)
Bluesky (planned)

Features

📰 Multiple news sources in one place
💾 SQLite caching for fast access and offline reading
🔍 Search across all cached items
⚙️ Easy configuration via JSON
🔄 Automatic feed refresh

Installation

cd ~/src/news-mcp-server
npm install
npm run build

Configuration

Project-Specific Setup (Recommended)

This project includes a .claude/mcp_settings.json file that automatically enables the news MCP server when you open Claude Code in this directory.

To use:

Open a new terminal
Navigate to this directory: cd ~/src/news-mcp-server
Start Claude Code in this directory
The news MCP server will be automatically available!

Global Configuration (Optional)

If you want the news server available in all Claude Code sessions, add this to your global Claude Code MCP settings:

{
  "mcpServers": {
    "news": {
      "command": "node",
      "args": ["/Users/norm.provost/src/news-mcp-server/build/index.js"]
    }
  }
}

RSS Feed Configuration

Create config/feeds.json (see config/feeds.json.example for template):

{
  "rss_feeds": [
    {
      "name": "techcrunch",
      "url": "https://techcrunch.com/feed/",
      "refresh_interval_minutes": 30
    }
  ]
}

Usage

Available Resources

Access feeds directly as resources:

feed://hackernews - Hacker News top stories
feed://rss:techcrunch - Specific RSS feed
feed://all - All sources combined

Available Tools

`list_sources`

List all configured feed sources.

`get_feed`

Fetch latest items from sources.

Parameters:
- source (optional): "hackernews", "rss:techcrunch", or "all"
- limit (optional): Max items to return (default: 30)
- hours_ago (optional): Only return items from last N hours

`refresh_cache`

Refresh cached data by fetching from sources.

Parameters:
- source (optional): Specific source to refresh, or all if not specified

`search_all`

Search across all cached items.

Parameters:
- query (required): Search query
- limit (optional): Max results (default: 50)

`add_rss_feed`

Add a new RSS feed source.

Parameters:
- name (required): Feed name (e.g., "techcrunch")
- url (required): RSS feed URL

`remove_rss_feed`

Remove an RSS feed source.

Parameters:
- name (required): Feed name to remove

Examples

In Claude Code

# Refresh Hacker News cache and read it
refresh_cache with source=hackernews
get_feed with source=hackernews limit=10

# Add a new RSS feed
add_rss_feed with name=arstechnica url=https://feeds.arstechnica.com/arstechnica/index

# Search for AI-related articles
search_all with query=AI limit=20

# Get recent items from all sources
get_feed with source=all hours_ago=24

Database

Feed items are cached in cache.db (SQLite). Old items are automatically cleaned after 7 days.

Development

# Build
npm run build

# Watch mode for development
npm run watch

Future Enhancements

[ ] Twitter integration (requires API key)
[ ] Bluesky AT Protocol integration
[ ] Automatic periodic refresh
[ ] Custom filters and rules
[ ] Export functionality
[ ] Web interface for configuration

Architecture

src/
├── index.ts              # Main MCP server
├── types.ts              # TypeScript types
├── sources/
│   ├── base.ts           # Source interface
│   ├── hackernews.ts     # Hacker News API
│   └── rss.ts            # RSS parser
└── storage/
    ├── database.ts       # SQLite operations
    └── config.ts         # Feed configuration

License

MIT

news-mcp-server