reddit-mcp

Сервер протокола контекста модели (MCP) только для чтения, который оборачивает API Reddit для просмотра сабреддитов, поиска внутри них, извлечения веток комментариев и поиска активности пользователей. Предназначен для личного отслеживания r/homelabsales, r/hardwareswap и подобных сабреддитов через Claude Code и Claude Desktop. Написан на Python, работает локально через stdio.

Уровни аутентификации (все опциональны)

Сервер автоматически определяет, какой из трех уровней использовать, исходя из установленных вами переменных окружения:

Новые пользователи: начните с анонимного уровня. Reddit прекратил самостоятельное создание ключей API в ноябре 2025 года (Политика ответственного разработчика), поэтому получение учетных данных OAuth теперь требует одобрения, которое обычно отклоняет личные скрипты. Анонимный уровень покрывает все пути чтения, реализованные этим сервером. Подробности см. в разделе 3.2 docs/design.md.

Related MCP server: Reddit MCP Server

Установка плагина (локальная разработка)

Весь репозиторий является плагином Claude Code (навык + слэш-команды + сервер MCP в комплекте). Чтобы попробовать его локально:

cd /Users/conrad/Ai/reddit_mcp
uv pip install -e .                                          # one-time, sets up the MCP server in a venv
claude plugin marketplace add /Users/conrad/Ai/reddit_mcp    # register this repo as a local marketplace
claude plugin install reddit-deal-hunter@reddit-mcp-local    # install + enable the plugin

Перезапустите Claude Code. При первой активации MCP вам будет предложено заполнить пять полей (reddit_user_agent, reddit_client_id, reddit_client_secret, reddit_username, reddit_password), все они опциональны. Оставьте любые или все поля пустыми, чтобы остаться на более низком уровне. Установка reddit_user_agent рекомендуется независимо от уровня; используйте формат macos:reddit-mcp:0.2 (by /u/yourusername).

После активации станут доступны навык, команды /reddit-deal-hunter:scan и /reddit-deal-hunter:thread-check, а также все четыре инструмента MCP (get_subreddit_posts, search_subreddit, get_post_details, user_analysis).

Внимание: по состоянию на апрель 2026 года уровень MCP в пакете плагинов может не подключать инструменты к сессиям Claude Code при каждой установке (встроенный mcpServers в plugin.json задокументирован как поддерживаемый, но поведение среды выполнения GUI варьируется). Если навык и слэш-команды отображаются, а инструменты mcp__reddit_mcp__* — нет, вернитесь к пути установки только через MCP ниже. Подробности см. в docs/tool-ux-findings.md и HANDOFF.md (дополнение к сессии 5).

Ручная установка (только MCP, без плагина) — на данный момент самый надежный путь

Если вам нужен только сервер MCP (без навыка, без слэш-команд) или если установка уровня плагина выше не подключает инструменты MCP к вашей сессии, зарегистрируйте его в Claude Code напрямую на уровне пользователя:

cd /Users/conrad/Ai/reddit_mcp
uv venv --python 3.12
uv pip install -e .

# Anonymous (zero credentials):
claude mcp add reddit_mcp \
  --scope user \
  --env REDDIT_USER_AGENT="macos:reddit-mcp:0.2 (by /u/yourusername)" \
  -- uv run --directory /Users/conrad/Ai/reddit_mcp reddit-mcp

# OAuth app-only (add client creds):
claude mcp add reddit_mcp \
  --scope user \
  --env REDDIT_USER_AGENT="macos:reddit-mcp:0.2 (by /u/yourusername)" \
  --env REDDIT_CLIENT_ID=YOUR_REDDIT_CLIENT_ID \
  --env REDDIT_CLIENT_SECRET=YOUR_REDDIT_CLIENT_SECRET \
  -- uv run --directory /Users/conrad/Ai/reddit_mcp reddit-mcp

Проверьте с помощью claude mcp list (ожидается reddit_mcp ✓ Connected) и перезапустите Claude Code, чтобы инструменты подключились к новым сессиям.

См. раздел 7 docs/design.md для регистрации в Claude Desktop и настройки других клиентов.

Структура репозитория

reddit-mcp/
├── .claude-plugin/
│   ├── plugin.json                 # plugin manifest + inline mcpServers block
│   └── marketplace.json            # single-plugin local-marketplace descriptor
├── CLAUDE.md                       # repo-specific working notes for Claude Code
├── commands/                       # user-invoked slash commands
│   ├── scan.md                     # /reddit-deal-hunter:scan <query>
│   └── thread-check.md             # /reddit-deal-hunter:thread-check <permalink-or-id>
├── docs/
│   ├── design.md                   # full design, the authoritative read
│   ├── supply-chain-baseline.md    # pinned-deps audit baseline
│   └── tool-ux-findings.md         # known issues surfaced by the live eval run
├── evals/
│   └── reddit_eval.xml             # 10 qa_pairs for mcp-builder evaluation
├── pyproject.toml                  # mcp, httpx (pinned)
├── reddit_mcp.py                   # the MCP server (uses mcp SDK FastMCP)
├── skills/
│   └── deal-hunter/SKILL.md        # model-invoked deal-watching heuristics
└── tests/test_smoke.py             # module import + tool registration

Статус

Pre-v1. Анонимный уровень работает от начала до конца без учетных данных (проверено в реальном времени на Reddit; 10/10 пройдено в наборе тестов). Пути обновления до OAuth работают, если у вас есть учетные данные. Оставшаяся работа над v1: рефакторинг проекции ответов инструментов, отслеживаемый в docs/tool-ux-findings.md. Публичный релиз после проверки v1.

См. docs/design.md для полного описания дизайна и обоснования, CLAUDE.md для рабочих заметок и HANDOFF.md для передачи между сессиями.

Лицензия

MIT.