RSS MCP Server
A FastMCP server implementation for RSS feed management using the Fever API.
Installation
- Clone the repository
- Install dependencies:
pip install -r requirements.txt
Configuration
- Copy
.env.exampleto.env:
cp .env.example .env
- Edit
.envand set your configuration values:
FEVER_API_URL: URL of your Fever API endpointFEVER_USERNAME: Your Fever API usernameFEVER_PASSWORD: Your Fever API passwordMCP_SERVER_NAME: Name for your MCP server instance
- Configure Cursor Integration:
Create or edit your Cursor MCP configuration file at ~/.cursor/mcp.json:
{
"mcpServers": {
"RssMcpServer": {
"url": "http://127.0.0.1:8000/sse"
}
}
}
This configuration will allow Cursor to connect to your RSS MCP server running locally on port 8000.
Running the Server
Start the server using:
python main.py
API Tools
The server provides the following MCP tools:
Feed Management
get_feeds(): Retrieve all RSS feedsget_groups(): Retrieve all feed groups
Item Operations
get_unread_items(max_items=10, max_id=9999999999, since_id="", feed_ids=None, group_ids=None): Get unread itemsget_saved_items(max_items=10, max_id=9999999999): Get saved/favorited itemsget_items(since_id=""): Get items since a specific IDget_items_by_feed_ids(feed_ids, max_items=10): Get items from specific feedsget_items_by_group_ids(group_ids, max_items=10): Get items from specific groupsmark_item(item_id, action): Mark items as read/saved/unsaved
Dependencies
- starlette>=0.27.0
- requests>=2.31.0
- python-dotenv>=1.0.0
- fastmcp>=0.1.0
- uvicorn>=0.24.0
License
MIT License
Metadata
Release files for iflow-mcp_weekend-project-space-rss-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_weekend_project_space_rss_mcp_server-0.1.0.tar.gz | 6.1 kB | Without provenance | Details for iflow_mcp_weekend_project_space_rss_mcp_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_weekend_project_space_rss_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_weekend_project_space_rss_mcp_server-0.1.0-py3-none-any.whl |
Total release size: 18.0 kB
Release files / iflow_mcp_weekend_project_space_rss_mcp_server-0.1.0.tar.gz
| Download URL | iflow_mcp_weekend_project_space_rss_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 6.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b24476813547926bc468337e6d095805745c620af9edeaf08bc1713237e6debb
|
|
BLAKE2b-256 checksum How to use checksums |
60c02863d3584e577b1740093065a25aa1f25fe0a6caeafab69d89b7aff9189a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_weekend_project_space_rss_mcp_server-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_weekend_project_space_rss_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 11.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fe1446a2b01acdc3fc4240c80a924aef38c77396ef90d30f7620c9deda67959e
|
|
BLAKE2b-256 checksum How to use checksums |
4f98bba9092c655e3ed71331429fd59271a7208fb6dae4d43f940c566268b358
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_weekend-project-space-rss-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.