Reddit MCP Server

Un servidor de Model Context Protocol (MCP) para interactuar con Reddit: obtener publicaciones, comentarios, información de usuarios y crear contenido.

Características de un vistazo

Related MCP server: Reddit MCP Server

Inicio rápido

Opción 1: Extensión de Claude Desktop (la más fácil)

Descarga y abre el archivo de extensión: Claude Desktop lo instalará automáticamente:

Descargar reddit-mcp-server.mcpb

Opción 2: NPX (sin instalación requerida)

npx reddit-mcp-server

O añádelo a tu configuración de MCP (Claude Desktop, Cursor, etc.):

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

Opción 3: Claude Code

claude mcp add --transport stdio reddit -- npx reddit-mcp-server

Características

Herramientas de solo lectura

Herramientas de escritura (requieren credenciales de usuario)

Configuración

Variables de entorno

*Requerida solo si se usa el modo authenticated.

Ejemplo completo de configuración de MCP

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-server"],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_USERNAME": "your_username",
        "REDDIT_PASSWORD": "your_password",
        "REDDIT_SAFE_MODE": "standard"
      }
    }
  }
}

Modo seguro (protección contra spam)

Protege tu cuenta de Reddit de la detección de spam y baneos con salvaguardas integradas. Habilitado por defecto (modo standard) según la Política de Constructores Responsables de Reddit.

¿Por qué usar el modo seguro?

La detección de spam de Reddit puede marcar cuentas por:

• Publicar o comentar rápidamente

• Contenido duplicado o similar

• Publicar el mismo contenido en múltiples subreddits

• Cadenas de User-Agent no estándar

El modo seguro ayuda a prevenir estos problemas automáticamente.

Opciones de modo

Deshabilitar el modo seguro

El modo seguro está habilitado por defecto. Para deshabilitarlo explícitamente:

export REDDIT_SAFE_MODE=off
npx reddit-mcp-server

Qué hace el modo seguro

1. Limitación de velocidad: aplica retrasos mínimos entre operaciones de escritura

2. Detección de duplicados: bloquea que el mismo contenido se publique dos veces

3. Detección entre subreddits: evita publicar el mismo contenido en múltiples subreddits (según la política de Reddit)

4. User-Agent inteligente: genera automáticamente un formato de User-Agent compatible con Reddit cuando se proporciona el nombre de usuario

Divulgación de bot

La Política de Constructores Responsables de Reddit requiere que los bots revelen su naturaleza automatizada. Habilita pies de página automáticos de bot en todo el contenido publicado:

export REDDIT_BOT_DISCLOSURE=auto
npx reddit-mcp-server

Cuando está habilitado, se agrega un pie de página a todas las publicaciones, respuestas y ediciones:

---
🤖 I am a bot | Built with reddit-mcp-server

Personaliza el pie de página con REDDIT_BOT_FOOTER:

export REDDIT_BOT_DISCLOSURE=auto
export REDDIT_BOT_FOOTER=$'\n\n---\n^(🤖 Custom bot footer text)'

Modos de autenticación

Comparación de modos

Modo anónimo (sin configuración)

{
  "env": {
    "REDDIT_AUTH_MODE": "anonymous"
  }
}

El modo anónimo no funciona en todas las redes. Reddit bloquea solicitudes no autenticadas de muchos rangos de IP (centros de datos, hosts en la nube, VPN y direcciones que ha marcado) y responde con una página de bloqueo HTTP 403. Si te encuentras con esto, las herramientas fallan con:

Reddit is blocking unauthenticated requests from this network (HTTP 403 with a
block page). Set REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET to authenticate with
OAuth, which also raises the rate limit from ~10 to 60+ requests/min.

La solución son las credenciales OAuth; consulta la siguiente sección. Esto es una propiedad de tu red, no de tu cuenta de Reddit ni del subreddit que solicitaste, por lo que afecta a todas las herramientas a la vez. Un 403 en un solo subreddit mientras otros funcionan es algo diferente: ese subreddit es privado o está en cuarentena.

Modo autenticado (límites de velocidad más altos)

1. Crea una aplicación de Reddit en https://www.reddit.com/prefs/apps (selecciona el tipo "script")

2. Copia el ID de cliente y el secreto

3. Configura:

{
  "env": {
    "REDDIT_AUTH_MODE": "authenticated",
    "REDDIT_CLIENT_ID": "your_client_id",
    "REDDIT_CLIENT_SECRET": "your_client_secret"
  }
}

Operaciones de escritura

Para crear publicaciones, responder, editar o eliminar contenido, necesitas credenciales de usuario:

{
  "env": {
    "REDDIT_USERNAME": "your_username",
    "REDDIT_PASSWORD": "your_password",
    "REDDIT_SAFE_MODE": "standard"
  }
}

Desarrollo

Comandos

pnpm install        # Install dependencies
pnpm build          # Build TypeScript
pnpm dev            # Build and run MCP inspector
pnpm test           # Run tests
pnpm lint           # Lint code
pnpm format         # Format code

Opciones de CLI

npx reddit-mcp-server --version         # Show version
npx reddit-mcp-server --help            # Show help
npx reddit-mcp-server --generate-token  # Generate OAuth token for HTTP mode

Modo de servidor HTTP

Para implementaciones con Docker o clientes basados en web, usa transporte HTTP:

TRANSPORT_TYPE=httpStream PORT=3000 node dist/index.js

Con protección OAuth

export OAUTH_ENABLED=true
export OAUTH_TOKEN=$(npx reddit-mcp-server --generate-token | tail -1)
TRANSPORT_TYPE=httpStream node dist/index.js

Haz solicitudes autenticadas:

curl -H "Authorization: Bearer $OAUTH_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"method":"tools/list","params":{}}' \
     http://localhost:3000/mcp

Docker

Inicio rápido

# Pull and run
docker pull ghcr.io/jordanburke/reddit-mcp-server:latest

docker run -d \
  --name reddit-mcp \
  -p 3000:3000 \
  -e REDDIT_CLIENT_ID=your_client_id \
  -e REDDIT_CLIENT_SECRET=your_client_secret \
  -e REDDIT_SAFE_MODE=standard \
  ghcr.io/jordanburke/reddit-mcp-server:latest

Docker Compose

services:
  reddit-mcp:
    image: ghcr.io/jordanburke/reddit-mcp-server:latest
    ports:
      - "3000:3000"
    environment:
      - REDDIT_CLIENT_ID=${REDDIT_CLIENT_ID}
      - REDDIT_CLIENT_SECRET=${REDDIT_CLIENT_SECRET}
      - REDDIT_USERNAME=${REDDIT_USERNAME}
      - REDDIT_PASSWORD=${REDDIT_PASSWORD}
      - REDDIT_SAFE_MODE=standard
      - OAUTH_ENABLED=${OAUTH_ENABLED:-false}
      - OAUTH_TOKEN=${OAUTH_TOKEN}
    restart: unless-stopped

Compilar localmente

docker build -t reddit-mcp-server .
docker run -d --name reddit-mcp -p 3000:3000 --env-file .env reddit-mcp-server

Política de Constructores Responsables de Reddit

Este servidor está diseñado teniendo en cuenta la Política de Constructores Responsables de Reddit:

• Modo seguro activado por defecto: la limitación de velocidad y la detección de duplicados previenen el spam

• Detección de duplicados entre subreddits: bloquea contenido idéntico en diferentes subreddits

• Soporte de divulgación de bot: pie de página automático opcional para transparencia

• Sin manipulación de votos/karma: las herramientas de votar a favor/en contra están excluidas intencionalmente

• Sin mensajería privada: las herramientas de mensajes directos están excluidas intencionalmente

• Instrucciones de IA conscientes de la política: las instrucciones del servidor MCP recuerdan a los asistentes de IA las restricciones de uso de datos

Créditos

• Bifurcación de reddit-mcp-server por Alexandros Lekkas

• Inspirado en Python Reddit MCP Server por Arindam200