{"id":31054448,"url":"https://github.com/kwp-lab/rss-reader-mcp","last_synced_at":"2025-09-27T02:22:55.176Z","repository":{"id":314063093,"uuid":"1053985063","full_name":"kwp-lab/rss-reader-mcp","owner":"kwp-lab","description":"MCP server for RSS feed aggregation and article content extraction","archived":false,"fork":false,"pushed_at":"2025-09-10T08:32:57.000Z","size":55,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-10T11:50:26.299Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kwp-lab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-10T07:52:49.000Z","updated_at":"2025-09-10T08:33:00.000Z","dependencies_parsed_at":"2025-09-10T12:02:33.057Z","dependency_job_id":null,"html_url":"https://github.com/kwp-lab/rss-reader-mcp","commit_stats":null,"previous_names":["kwp-lab/rss-reader-mcp"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/kwp-lab/rss-reader-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kwp-lab%2Frss-reader-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kwp-lab%2Frss-reader-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kwp-lab%2Frss-reader-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kwp-lab%2Frss-reader-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kwp-lab","download_url":"https://codeload.github.com/kwp-lab/rss-reader-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kwp-lab%2Frss-reader-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277170908,"owners_count":25773093,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-27T02:00:08.978Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-15T03:02:35.540Z","updated_at":"2025-09-27T02:22:55.171Z","avatar_url":"https://github.com/kwp-lab.png","language":"JavaScript","funding_links":[],"categories":["Search \u0026 Data Extraction","カテゴリ","Content Extraction \u0026 Summarization Mcp Servers"],"sub_categories":["How to Submit","📝 \u003ca name=\"content--media\"\u003e\u003c/a\u003eコンテンツ・メディア"],"readme":"# RSS Reader MCP\n\nAn MCP (Model Context Protocol) server for RSS feed aggregation and article content extraction. You can use it to subscribe to RSS feeds and get article lists, or extract the full content of an article from a URL and format it as Markdown.\n\nEnglish | [中文](./README_zh.md)\n\n[![npm version](https://img.shields.io/npm/v/rss-reader-mcp.svg)](https://www.npmjs.com/package/rss-reader-mcp)\n[![license](https://img.shields.io/github/license/kwp-lab/rss-reader-mcp.svg)](LICENSE)\n[![build status](https://img.shields.io/github/actions/workflow/status/kwp-lab/rss-reader-mcp/publish.yml?branch=main)](https://github.com/kwp-lab/rss-reader-mcp/actions/workflows/publish.yml)\n[![smithery badge](https://smithery.ai/badge/@kwp-lab/rss-reader-mcp)](https://smithery.ai/server/@kwp-lab/rss-reader-mcp)\n\n## 🚀 Quick Start\n\nYou can use this MCP server in MCP-capable clients such as [Claude Desktop](https://claude.ai/download) and [CherryStudio](https://www.cherry-ai.com/).\n\n### Claude Desktop\n\nFor Claude Desktop, add the following configuration under the \"mcpServers\" section in your `claude_desktop_config.json` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"rss-reader\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"rss-reader-mcp\"\n      ]\n    }\n  }\n}\n```\n\n### Usage Examples\n\n- Basic RSS feed fetching\n\n  \u003e Can you fetch the latest 5 headlines from the BBC News RSS feed?\n  \u003e URL: \u003chttps://feeds.bbci.co.uk/news/rss.xml\u003e\n\n- Full article content extraction\n  \u003e Please extract the full content of this article and format it as Markdown:\n  \u003e \u003chttps://example.com/news/article-title\u003e\n\n## 🔧 Tools Reference\n\n### `fetch_feed_entries`\n\nFetch RSS entries from a specified URL\n\n**Parameters:**\n\n- `url` (required string): RSS feed URL\n- `limit` (optional number): Maximum number of entries to return (default 10, max 100)\n\n**Returns:** A JSON object containing feed metadata and a list of entries (including title, link, publication date, and summary)\n\n### `fetch_article_content`\n\nExtract article content from a URL and format it as Markdown\n\n**Parameters:**\n\n- `url` (required string): Article URL\n\n**Returns:** A JSON object containing the title, Markdown content, source URL, and timestamp\n\n## ⚙️ Transport \u0026 Environment Variables\n\nThis server supports two transport modes:\n\n- stdio (default): Communicates via standard input/output. Suitable for clients that run a local process, such as Claude Desktop.\n- httpStream: Communicates over HTTP streaming. Suitable for clients that support HTTP(S) transport or for containerized deployments.\n\nAvailable environment variables:\n\n- TRANSPORT: Select the transport mode, either `stdio` (default) or `httpStream`.\n- PORT: When `TRANSPORT=httpStream`, the listening port (default `8081`).\n- MCP_SERVER_HOST: When `TRANSPORT=httpStream`, the listening address (default `localhost`). In Docker, set this to `0.0.0.0` to expose the port externally.\n\nHow to switch transport modes:\n\n- Using stdio (no extra setup, default):\n  - Works with Claude Desktop via the `command + args` configuration (see example above).\n- Using httpStream:\n  - Set the environment variable `TRANSPORT=httpStream` and specify `PORT` (defaults to 8081 if not set).\n  - When running in a container, also set `MCP_SERVER_HOST=0.0.0.0` and map the port.\n  - The Dockerfile in this repository already includes related environment variable settings.\n\n## Docker Deployment\n\nYou can also run this MCP server in a Docker container. First, build the image in the project root:\n\n```bash\ndocker build -t rss-reader-mcp .\n```\n\nUsing CherryStudio as an example, the following configuration shows how to run this server over HTTP:\n\n```json\n{\n  \"mcpServers\": {\n    \"rss-reader-mcp\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-p\",\n        \"8081:8081\",\n        \"-e\",\n        \"PORT=8081\",\n        \"rss-reader-mcp\"\n      ]\n    }\n  }\n}\n```\n\n## Some RSS Feeds for Testing\n\n- **BBC News:** `https://feeds.bbci.co.uk/news/rss.xml`\n- **TechCrunch:** `https://techcrunch.com/feed/`\n- **Hacker News:** `https://hnrss.org/frontpage`\n- **MIT Technology Review:** `https://www.technologyreview.com/feed/`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkwp-lab%2Frss-reader-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkwp-lab%2Frss-reader-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkwp-lab%2Frss-reader-mcp/lists"}