Skip to main content

A Universal MCP Application: universal_mcp_reddit

Project description

Reddit Universal MCP Server

This repository contains an implementation of an Reddit Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Reddit's SEO and backlink analysis tools 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.

Usage

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

Available Tools

The full list of available tools is at ./src/universal_mcp_reddit/README.md

Local Development

📋 Prerequisites

Ensure you have the following before you begin:

  • Python 3.11+ (recommended)
  • uv (install globally with pip install uv)

🛠️ Setup Instructions

Follow the steps below to set up your development environment:

  1. Sync Project Dependencies

    uv sync
    

    This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

  2. Activate the Virtual Environment

    For Linux/macOS:

    source .venv/bin/activate
    

    For Windows (PowerShell):

    .venv\Scripts\Activate
    
  3. Start the MCP Inspector

    mcp dev src/universal_mcp_reddit/mcp.py
    

    This will start the MCP inspector. Make note of the address and port shown in the console output.

  4. Install the Application

    mcp install src/universal_mcp_reddit/mcp.py
    

📁 Project Structure

.
├── src/
│   └── universal_mcp_reddit/
│       ├── __init__.py       # Package initializer
│       ├── mcp.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

📄 License

This project is licensed under the MIT License.


Generated with MCP CLI — Happy coding! 🚀

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

universal_mcp_reddit-0.1.2.tar.gz (138.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

universal_mcp_reddit-0.1.2-py3-none-any.whl (20.3 kB view details)

Uploaded Python 3

File details

Details for the file universal_mcp_reddit-0.1.2.tar.gz.

File metadata

File hashes

Hashes for universal_mcp_reddit-0.1.2.tar.gz
Algorithm Hash digest
SHA256 aac02cef5dbc8ba939a626b026ca852c8ffc26a12b8ad1fc4a3ed29918a9b635
MD5 5ffe371fa0a128cb8bbbdbb977a40ee0
BLAKE2b-256 b534fd1a0d06964b60a1f155534d5405dcceb34a720ca02c271c56ebe5750f98

See more details on using hashes here.

File details

Details for the file universal_mcp_reddit-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for universal_mcp_reddit-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 be4d502bbaef1d09b74ac66fcdd7904daf75b9ce8d861a32d959b19356e2f7de
MD5 4063d00ef235721c1bfe3e68cc485198
BLAKE2b-256 1d6d20c0040a32dd783d09f6c6c1c52b8b1ce64f81d1c8b8931937baed88094e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page