mcp-server-rsshub

MCP Server for RSSHub

An MCP server implementation that integrates the RSSHub API with Claude following the Model Context Protocol (MCP) standard. This server allows Claude to fetch and parse RSS feeds from across the web.

Features

• Dynamic discovery of RSSHub routes and automatic tool creation
• OpenAPI schema integration for standardized tool access
• Standardized error handling and multiple fallback mechanisms
• JSON feed format support with proper content parsing
• Tools for fetching Twitter/X user timelines and other popular content
• Configurable base URL via environment variable RSSHUB_BASE_URL

Installation

Install globally:

npm install -g mcp-server-rsshub

Or use directly with npx:

npx mcp-server-rsshub

Quick Start Examples

Here are the most reliable prompts to use with Claude:

Can you fetch recent tweets from @elonmusk and summarize them?

Get me the latest release information for the React repository on GitHub using RSSHub.

What are the top stories on HackerNews right now?

Fetch the latest tech news from TechCrunch and organize it by category.

Available Tools

The server provides the following key tools:

Primary OpenAPI Tools

• openapi-getTwitterUserTimeline: Get tweets from a Twitter/X user
• openapi-getGitHubRelease: Get GitHub repository releases
• openapi-getHackerNews: Get HackerNews front page
• openapi-getTechCrunch: Get TechCrunch news

Utility Tools

• rsshub-get-schema: Get the input schema for any tool
• rsshub-get-routes: Get all available routes from RSSHub
• rsshub-twitter-user: Convenient access to Twitter user timelines

API Examples

// Get recent tweets from a user
const tweets = await callMCPTool("openapi-getTwitterUserTimeline", {
  username: "anthropic",
  format: "json"
});

// Get GitHub releases for a repository
const releases = await callMCPTool("openapi-getGitHubRelease", {
  owner: "facebook",
  repo: "react",
  format: "json"
});

// Get HackerNews front page
const news = await callMCPTool("openapi-getHackerNews", {
  format: "json"
});

// Get TechCrunch news
const techNews = await callMCPTool("openapi-getTechCrunch", {
  format: "json"
});

Recommended Prompts for Claude

For the most reliable results, use these example prompts:

Fetch the latest tweets from @elonmusk and summarize the key topics he's discussing.

What are the latest releases for the React repository on GitHub? Please check using RSSHub.

Give me the top 5 stories from HackerNews right now and summarize each one in a sentence.

What are the latest tech news headlines from TechCrunch? Please organize them by category.

Usage with AI Applications

Usage with Claude Desktop

{
  "mcpServers": {
    "rsshub": {
      "command": "npx",
      "args": [
        "mcp-server-rsshub"
      ]
    }
  }
}

Usage with Cursor

• Open Settings → Cursor Settings
• Click on "MCP"
• Add new MCP Server with:

{
  "mcpServers": {
    "rsshub": {
      "command": "npx",
      "args": [
        "mcp-server-rsshub"
      ]
    }
  }
}

Environment Variables

• RSSHUB_BASE_URL: Set a custom RSSHub instance (default is https://rsshub.pseudoyu.com)

Example:

export RSSHUB_BASE_URL=https://rsshub.app
npx mcp-server-rsshub

Troubleshooting

If you encounter issues:

• Check that your RSSHub instance is accessible
• Try the direct rsshub-twitter-user tool which has additional fallback mechanisms
• Use explicit parameters (e.g., specify format as "json")
• Check console output for detailed error messages

License

MIT