Reddit MCP Server

Servidor MCP que permite a Claude (y otros clientes MCP) escanear, buscar y leer publicaciones y comentarios de Reddit.

Herramientas

Related MCP server: reddit-mcp

Configuración

npm install
npm run build

Requiere Node.js 18 o superior.

El servidor utiliza los endpoints JSON públicos de Reddit y no requiere credenciales de API de Reddit.

Configuración de Claude Desktop

Agrega a tu configuración de Claude Desktop (~/.config/Claude/claude_desktop_config.json en macOS/Linux, %APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "reddit": {
      "command": "node",
      "args": ["/absolute/path/to/reddit-mcp/dist/server.js"]
    }
  }
}

Reemplaza la ruta de ejemplo con la ruta donde clonaste este repositorio.

Configuración de VS Code MCP

Agrega a la configuración de VS Code (.vscode/mcp.json):

{
  "servers": {
    "reddit": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/dist/server.js"]
    }
  }
}

Al configurar esto fuera del espacio de trabajo del repositorio, reemplaza ${workspaceFolder} con la ruta absoluta al repositorio clonado.

Ejemplos de uso

Una vez conectado, Claude puede usar estas herramientas:

• Escanear un subreddit: "Muéstrame las 20 publicaciones principales de r/programming esta semana"

• Buscar publicaciones: "Busca en Reddit 'tutorial de servidor MCP'"

• Obtener detalles de una publicación: "Obtén los comentarios de esa primera publicación"

Arquitectura

• src/server.ts — Entrada del servidor MCP, registro de herramientas, transporte stdio

• src/tools/ — Manejadores de herramientas individuales con validación de entrada

• src/reddit/ — Cliente de datos de Reddit con abstracción de proveedor

• src/reddit/providers/publicJson.ts — Proveedor de endpoints JSON públicos (MVP)

• src/core/ — Tipos compartidos, validación y taxonomía de errores

• src/tests/ — Pruebas unitarias para caché y deduplicación de comentarios

La interfaz del proveedor (RedditProvider) facilita cambiar al API OAuth de Reddit más adelante sin modificar ningún código de las herramientas.