MCP Server Reddit

🚀 MCP Server Reddit - Complete Translation

MCP Server Reddit is a Model Context Protocol (MCP) server designed to interact with the Reddit platform. It enables AI models to enhance their understanding by accessing Reddit posts, subreddit information, and other relevant data.

✨ Features

• Fetch Current Hot Posts: View the trending content on the Reddit homepage.
• Subreddit Information Query: Get the basic details of specific subreddits (e.g., r/ClaudeAI).
• Multi - Type Post Retrieval: Retrieve hot, new, top, and trending posts.
• Detailed Content and Comment Extraction: Analyze the content of specific Reddit posts and their associated comments.

📦 Installation

Install via pip

You can easily install MCP Server Reddit using pip:

pip install mcp-server-reddit

After installation, start the service with the following command:

python -m mcp_server_reddit

Install via Smithery

If you are using Claude Desktop, you can install it automatically via Smithery:

npx -y @smithery/cli install @Hawstein/mcp-server-reddit --client claude

📚 Configuration

Configuration for Claude.app

Add the following configuration to your Claude settings:

Configuration using uvx:

"mcpServers": {
  "reddit": {
    "command": "uvx",
    "args": ["mcp-server-reddit"]
  }
}

Configuration for pip installation:

"mcpServers": {
  "reddit": {
    "command": "python",
    "args": ["-m", "mcp_server_reddit"]
  }
}

Configuration for Zed

Add the following content to your Zed settings.json file:

Configuration using uvx:

"context_servers": [
  {
    "mcp-server-reddit": {
      "command": "uvx",
      "args": ["mcp-server-reddit"]
    }
  }
],

Configuration for pip installation:

"context_servers": {
  "mcp-server-reddit": {
    "command": "python",
    "args": ["-m", "mcp_server_reddit"]
  }
},

💻 Usage Examples

Example Queries

• Fetch Hot Posts on Reddit Homepage: Ask for the current trending content on Reddit.
• Query Subreddit Information: Get the basic details of a specific subreddit.
• Fetch Hot Posts in a Subreddit: View the popular discussions within a subreddit.
• Fetch Newest Content in a Subreddit: Keep up with the latest developments in a subreddit.
• Analyze Historical High - light Posts in a Subreddit: View the classic or top - rated content in a subreddit.
• Track Trend Changes in a Subreddit: Observe the currently popular content in a subreddit.

🔧 Debugging

For users who installed via uvx:

npx @modelcontextprotocol/inspector uvx mcp-server-reddit

If you installed manually or are in a development environment, execute the following command:

cd path/to/mcp_server_reddit
npx @modelcontextprotocol/inspector uv run mcp-server-reddit

📄 License

MCP Server Reddit is licensed under the MIT License, which means you are free to use, modify, and distribute the software. For more detailed information, please refer to the LICENSE file in the project repository.