Skip to main content
Glama
deenesjakoruzh
KalGuinn

reddit-mcp

by KalGuinn
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

reddit-mcp

サブレディットの閲覧、サブレディット内検索、コメントツリーの取得、ユーザーアクティビティの検索のためにReddit APIをラップする、読み取り専用のModel Context Protocolサーバーです。Claude CodeやClaude Desktopを介して、r/homelabsales、r/hardwareswapなどのサブレディットを個人的に追跡することを目的としています。Pythonで記述されており、stdio経由でローカルで実行されます。

認証ティア（すべてオプション）

サーバーは、設定した環境変数から使用する3つのティアのいずれかを自動的に検出します。

ティア

レート制限

環境変数

備考

匿名

10 rpm

REDDIT_USER_AGENT (推奨)

設定不要で動作します。公開されている .json エンドポイントを使用します。

アプリ専用OAuth

60 rpm

上記 + REDDIT_CLIENT_ID + REDDIT_CLIENT_SECRET

Redditアプリが必要です。

認証済み

100 rpm

上記 + REDDIT_USERNAME + REDDIT_PASSWORD

パスワード付与。パスワードはプレーンテキストの設定ファイルに保存されます。

新規ユーザー: 匿名から始めてください。Redditは2025年11月にセルフサービスのAPIキー作成を終了したため（Responsible Builder Policy）、現在OAuth認証情報を取得するには、通常個人のスクリプトを拒否する承認ゲートが必要です。匿名ティアで、このサーバーが実装するすべての読み取りパスをカバーできます。詳細については docs/design.md のセクション3.2を参照してください。

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アクティベーション時に、5つのフィールド（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、そして4つのMCPツール（get_subreddit_posts、search_subreddit、get_post_details、user_analysis）が利用可能になります。

注意: 2026年4月現在、プラグインバンドルのMCPレイヤーは、インストールごとにClaude Codeセッションにツールをアタッチしない場合があります（plugin.json 内のインライン mcpServers はサポートされていると文書化されていますが、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を再起動して新しいセッションにツールをアタッチします。

Claude Desktopへの登録やその他のクライアント接続については、docs/design.md のセクション7を参照してください。

リポジトリの構成

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に対してライブ検証済み、eval-suite 10/10パス）。認証情報がある場合はOAuthアップグレードパスが機能します。残りのv1作業：docs/tool-ux-findings.md で追跡されているツール応答プロジェクションのリファクタリング。v1の検証後に公開リリース予定。

完全な設計と根拠については docs/design.md を、作業メモ版については CLAUDE.md を、セッション間の引き継ぎについては HANDOFF.md を参照してください。

ライセンス

MIT。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Reddit Server

    wllcnm
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that enables AI assistants like Claude to browse and analyze Reddit content, including searching subreddits, retrieving post details with comments, and viewing trending posts.
    10
    MIT

  • Reddit MCP Server

    susancodes55
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    A Model Context Protocol server that enables AI assistants to fetch Reddit content including consensus on topics, top posts, helpful links, and related subreddits.
    2
    -

  • reddit-mcp

    paltaio
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides access to public Reddit data through tools for searching subreddits, viewing posts, and reading comments without requiring authentication. It enables Model Context Protocol clients to interact with Reddit's public JSON API via stdio or HTTP transports.
    21 npm
    MIT

  • reddit_mcp

    ajaaysrinivaas
    A
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol server for reading public Reddit data and posting authenticated replies, enabling AI agents to interact with Reddit content.
    6
    MIT