Hawstein MCP Server Reddit

🚀 MCP Server Reddit Documentation

A powerful Reddit data interface for retrieving real-time post and subreddit information. It supports multiple installation methods and seamlessly integrates with Claude applications and other AI tools.

Video Demo Link

Click here to view the video demo

✨ Features

• Offers 9 different data interface functions.
• Supports real-time data retrieval from Reddit front pages and subreddits.
• Seamlessly integrates with Claude applications and other AI tools.
• Complete configuration options support multiple installation methods.

📦 Installation

Install using pip

pip install mcp-server-reddit

After installation, you can run it with the following command:

python -m mcp_server_reddit

Install via Smithery (for Claude Desktop)

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

📚 Configuration

Configuration for Claude Application

Using the uvx tool:

Add the following to your Claude settings:

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

Using the pip installation method:

Add the following to your Claude settings:

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

Configuration for Zed Application

Using the uvx tool:

Add the following to your Zed settings file:

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

Using the pip installation method:

Add the following to your Zed settings file:

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

💻 Usage Examples

• "What are the popular posts on the current Reddit front page?" (Call the get_frontpage_posts function)
• "Introduce the r/ClaudeAI subreddit" (Call the get_subreddit_info function)
• "View the popular posts in r/ClaudeAI" (Call the get_subreddit_hot_posts function)
• "Show the latest posts in r/ClaudeAI" (Call the get_subreddit_new_posts function)
• "What are the classic posts in the r/ClaudeAI subreddit?" (Call the get_subreddit_top_posts function)
• "What are the trending posts in the r/ClaudeAI subreddit?" (Call the get_subreddit_rising_posts function)
• "Get the full content and comments of this Reddit post: [post_url]" (Call the get_post_content function)
• "Summarize the comments of this Reddit post: [post_url]" (Call the get_post_comments function)

🔧 Debugging

For the uvx installation method, you can use the following command for debugging:

npx @modelcontextprotocol/inspector uvx mcp-server-reddit

If you installed it manually or during development, run the following command:

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

📄 License

The MCP Server Reddit project is licensed under the MIT License, which means you can freely use, modify, and distribute this software. Please refer to the LICENSE file in the project repository for specific terms.