Reddit MCP Server

MCP-сервер, который позволяет Claude (и другим MCP-клиентам) сканировать, искать и читать посты и комментарии Reddit.

Инструменты

Related MCP server: reddit-mcp

Настройка

npm install
npm run build

Требуется Node.js 18 или новее.

Сервер использует публичные JSON-эндпоинты Reddit и не требует учётных данных Reddit API.

Конфигурация Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/.config/Claude/claude_desktop_config.json на macOS/Linux, %APPDATA%\Claude\claude_desktop_config.json на Windows):

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

Замените примерный путь на путь, где вы клонировали этот репозиторий.

Конфигурация MCP в VS Code

Добавьте в настройки VS Code (.vscode/mcp.json):

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

При настройке вне рабочей области репозитория замените ${workspaceFolder} на абсолютный путь к клонированному репозиторию.

Примеры использования

После подключения Claude может использовать эти инструменты:

• Сканировать сабреддит: «Покажи мне топ-20 постов из r/programming за эту неделю»

• Искать посты: «Найди на Reddit 'MCP server tutorial'»

• Получить детали поста: «Получи комментарии на этот первый пост»

Архитектура

• src/server.ts — Точка входа MCP-сервера, регистрация инструментов, stdio-транспорт

• src/tools/ — Отдельные обработчики инструментов с валидацией входных данных

• src/reddit/ — Клиент данных Reddit с абстракцией провайдера

• src/reddit/providers/publicJson.ts — Провайдер публичных JSON-эндпоинтов (MVP)

• src/core/ — Общие типы, валидация и таксономия ошибок

• src/tests/ — Модульные тесты для кэширования и дедупликации комментариев

Интерфейс провайдера (RedditProvider) позволяет легко перейти на Reddit OAuth API позже без изменения кода инструментов.