by universal-mcp
A Universal MCP server for interacting with Reddit posts, comments, and subreddits.
This project is an implementation of a Reddit Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Reddit's tools and services through a unified API. Built using the Universal MCP framework, it ensures compatibility with other MCP-compliant services and tools.
You can start using Reddit directly from agentr.dev by visiting agentr.dev/apps and enabling Reddit. If you are new to universal mcp, follow the setup instructions at agentr.dev/quickstart.
For local development, ensure you have Python 3.11+ and uv
installed. Then, follow these steps:
uv sync
source .venv/bin/activate
(Linux/macOS) or .venv\Scripts\Activate
(Windows PowerShell)mcp dev src/universal_mcp_reddit/server.py
mcp install src/universal_mcp_reddit/server.py
Q: What is Universal MCP? A: Universal MCP (Model Context Protocol) is a framework that provides a standardized interface for interacting with various tools and services through a unified API.
Q: Where can I find the full list of available tools?
A: The full list of available tools can be found at ./src/universal_mcp_reddit/README.md
within the project repository.
Q: What are the prerequisites for local development?
A: You need Python 3.11+ and uv
installed to set up the local development environment.
This repository contains an implementation of an Reddit Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Reddit's tools and services through a unified API.
The server is built using the Universal MCP framework.
This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.
You can start using Reddit directly from agentr.dev. Visit agentr.dev/apps and enable Reddit.
If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart
The full list of available tools is at ./src/universal_mcp_reddit/README.md
Ensure you have the following before you begin:
pip install uv
)Follow the steps below to set up your development environment:
Sync Project Dependencies
uv sync
This installs all dependencies from pyproject.toml
into a local virtual environment (.venv
).
Activate the Virtual Environment
For Linux/macOS:
source .venv/bin/activate
For Windows (PowerShell):
.venv\Scripts\Activate
Start the MCP Inspector
mcp dev src/universal_mcp_reddit/server.py
This will start the MCP inspector. Make note of the address and port shown in the console output.
Install the Application
mcp install src/universal_mcp_reddit/server.py
.
├── src/
│ └── universal_mcp_reddit/
│ ├── __init__.py # Package initializer
│ ├── server.py # Server entry point
│ ├── app.py # Application tools
│ └── README.md # List of application tools
├── tests/ # Test suite
├── .env # Environment variables for local development
├── pyproject.toml # Project configuration
└── README.md # This file
This project is licensed under the MIT License.
Generated with MCP CLI — Happy coding! 🚀
Reviews feature coming soon
Stay tuned for community discussions and feedback