hackerdogs/reddit-mcp-server-mcp repository overview

⁠

⁠Reddit MCP Server (Upstream Image Wrapper)

MCP server wrapper for a comprehensive Reddit integration server — programmatic access to Reddit posts, comments, subreddits, and user data for AI agents.

⁠What is Reddit MCP Server?

This server provides a Model Context Protocol interface for Reddit, enabling AI agents to search subreddits, fetch posts and comments, browse feeds, and interact with Reddit content programmatically. It wraps the upstream Reddit MCP Server project and is designed for use by AI assistants that need structured access to Reddit community discussions.

No API keys required — this server connects to Reddit's public API endpoints and runs locally inside the Docker container.

Tools:

• reddit_mcp_server_info — Return basic info / status for Reddit MCP Server.

⁠Tools Reference

⁠Example Prompts

Here are example prompts you can use with Claude (or any MCP client) when this tool is connected:

• "Connect to Reddit and retrieve the top posts from r/programming this week."
• "Search Reddit for threads discussing 'prompt injection attacks' and summarize the findings."
• "Fetch the comment tree for a specific Reddit post URL and identify the most upvoted responses."
• "Monitor r/netsec for new posts about zero-day vulnerabilities."
• "List the hottest posts in r/LLMDevs from the last 24 hours."
• "Get the user flair and post history for a given Reddit username."

⁠Deploy

⁠Docker Compose (recommended)

docker-compose up -d

⁠Docker Run (stdio mode)

docker run -i --rm hackerdogs/reddit-mcp-server-mcp:latest

⁠Docker Run (HTTP streamable mode)

docker run -d -p 8447:8447 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_PORT=8447 \
  hackerdogs/reddit-mcp-server-mcp:latest

⁠MCP Client Configuration

⁠Stdio mode (default)

Add to your Claude Desktop or Cursor MCP config:

{
  "mcpServers": {
    "reddit-mcp-server-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT", "hackerdogs/reddit-mcp-server-mcp:latest"],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

⁠HTTP mode (streamable-http)

First, start the server using Docker Compose or docker run with HTTP mode (see Deploy⁠ above), then point your MCP client at the running server:

{
  "mcpServers": {
    "reddit-mcp-server-mcp": {
      "url": "http://localhost:8447/mcp"
    }
  }
}

⁠Environment Variables

⁠Installing in Hackerdogs

The fastest way to get started is through Hackerdogs⁠:

1. Log in to your Hackerdogs account.
2. Go to the Tools Catalog.
3. Search for the tool by name (e.g. "nuclei", "naabu", "julius").
4. Expand the tool card and click Install — you're ready to go.

1. Vendor API key required? Add your key in the config environment variable field before clicking Install. Your key will be encrypted at rest.
2. Enable / Disable the tool anytime from the Enabled Tools page.
3. Need to update a key or parameter? Go to My Tools → toggle Show Decrypted Values → edit → Save.

⁠Build

docker build -t hackerdogs/reddit-mcp-server-mcp:latest .

⁠Testing

⁠Automated tests

./test.sh

⁠Test directly with Docker

1. Start the server in HTTP mode:

docker run -d --rm --name reddit-mcp-server-mcp-test -p 8447:8447 \
  -e MCP_TRANSPORT=streamable-http \
  hackerdogs/reddit-mcp-server-mcp:latest

2. Initialize the MCP session:

SESSION_ID=$(curl -s -D - -X POST http://localhost:8447/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}' \
  2>&1 | grep -i mcp-session-id | awk '{print $2}' | tr -d '\r\n')

curl -s -X POST http://localhost:8447/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

3. Call a tool:

curl -s -X POST http://localhost:8447/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"run_reddit_server","arguments":{"arguments":"--help"}}}'

4. Clean up:

docker stop reddit-mcp-server-mcp-test

⁠Running the tool directly (bypassing MCP)

You can run the Reddit Server CLI in the same container by overriding the entrypoint without starting the MCP server.

Show help:

docker run -i --rm --entrypoint reddit-server hackerdogs/reddit-mcp-server-mcp:latest --help