Reddit (RSS)

reddit-mcp

Claude Code、Codex、ChatGPT Desktop など、MCP に対応したローカルクライアントから、API キーなしで Reddit を読めます。 アプリの登録もアカウントも不要です。

Reddit のデータ API は事実上閉鎖されています。新しいアプリにはモデレーション用途の申告と手動承認が必要で、匿名の .json アクセスはブロックされており、サードパーティ製ツールが利用していた無料枠もなくなりました。現在の「LLM 向け Reddit」連携の多くは、完了できない認証情報の手続きを要求するところから始まります。

Reddit は、すべてのサブレディット、スレッド、ユーザー、検索に対して、公開 Atom/RSS フィードを引き続き提供しています。この小さなローカル MCP サーバーは、これらのフィードを互換性のあるクライアントでツールとして利用できるようにします。サブレディットの閲覧、スレッドとコメントの読み取り、サイト全体の検索ができます。

これらのフィードは取得されることを前提に公開されているため、今も問題なく動作しています。2005 年から仕様が変わっていない形式で、サポート対象のパスを読み取るため、Reddit が次のデザイン変更を行ってもマークアップが壊れることはありません。

取得できないもの： スコア、賛成票の割合、コメント数です。これらは制限付き API でしか取得できず、ここではいずれも偽装しません。投稿とコメントのタイトル、投稿者、タイムスタンプ、全文はすべて取得できます。

インストール

reddit-rss-mcp は PyPI で公開されています（reddit-mcp という名前は無関係なプロジェクトが使用しています）。お使いの環境に uv が必要です。Python と依存関係は uv が自動で処理するため、ほかに設定するものはありません。

Claude Code：

claude mcp add reddit --scope user -- uvx reddit-rss-mcp

claude mcp get reddit または claude mcp list で確認してください。Claude Code が uvx を見つけられない場合は、コマンドをそのまま指定する代わりに、絶対パス（which uvx）を使用してください。

Codex CLI：

codex mcp add reddit -- uvx reddit-rss-mcp

codex mcp list で確認してください。代わりにローカルのチェックアウトを使用するには、次を実行します。

codex mcp add reddit -- uv --directory "$(pwd)" run server.py

Codex はプロジェクト単位の .codex/config.toml にも対応していますが、信頼されたチェックアウトごとにサーバーが自動設定・起動されるため、このリポジトリには含まれていません。

ChatGPT Desktop： Codex と MCP 設定を共有するため、上記の Codex コマンドで ChatGPT Desktop にも Reddit がインストールされます。ChatGPT アプリを再起動し、/mcp を使って接続済みのサーバーを確認してください。また、Settings → MCP servers → Add server から追加し、STDIO を選択して uvx reddit-rss-mcp と入力することもできます。

ChatGPT Work（ウェブ版）： ローカルの MCP 設定は読み込みません。プラグインと、それらが提供するリモート MCP ツールを使用します。

Claude Desktop、ワンクリック： 最新リリースから reddit-rss-mcp.mcpb をダウンロードし、ダブルクリックするか、Claude Desktop にドラッグするか、Settings → Extensions → Advanced settings → Install Extension を選択してください。JSON の編集も絶対パスの指定も不要です。（uvx reddit-rss-mcp を実行するため、引き続き uv を PATH に設定しておく必要があります。）

Claude Desktop、ローカルサーバーの手動設定： which uvx で確認した絶対パスを使い、~/Library/Application Support/Claude/claude_desktop_config.json に次の設定を追加してください（アプリはシェルの PATH を引き継ぎません）。

{
  "mcpServers": {
    "reddit": {
      "command": "/absolute/path/to/uvx",
      "args": ["reddit-rss-mcp"]
    }
  }
}

ファイルにほかのトップレベルキーがすでにある場合は、ファイルを上書きせず、それらと並べて mcpServers を追加してください。その後、次の手順を行います。

1. アプリを完全に終了します（ウィンドウを閉じるだけではなく、Cmd+Q を使います）。アプリの実行中にこのファイルが書き換えられるため、アプリを開いたまま編集すると変更が破棄されることがあります。
2. アプリを再起動します。 サーバーが登録されるまで、数回の再起動が必要な場合があります。
3. アプリの実行許可を求めるメッセージが表示されたら、サーバーの実行を許可します。

Cowork： 上記の .mcpb バンドルを Claude Desktop Extensions 経由でインストールしてください。Cowork は claude_desktop_config.json からローカルサーバーを読み込まないため、手動設定ではなくバンドルを使用してください。

ツール

ツール	機能
search_reddit(query, subreddit=None, sort="relevance", time_filter="all", limit=25)	トピックに関する実際のユーザーの意見や体験を知るために、Reddit のディスカッションを検索します。
browse_subreddit(subreddit, sort="hot", time_filter="day", limit=25)	コミュニティで今投稿されている内容を表示します（hot／new／top／rising／controversial）。
get_post(url, comment_limit=50)	1つのスレッド全体を取得します。投稿とコメントが含まれます（フラットなリストで、返信ツリーはフィードに含まれません）。
fetch_json(url)	その他の Reddit フィード形式を取得します：/user/<name>、マルチレディット、/domain/<site>。

fetch_json は、意図的に汎用的なウェブ取得ツールではありません。REDDIT_MCP_ALLOW_ANY_URL=1 を指定してサーバーを起動しない限り、他のホストの URL は拒否されます。これにより、関係のない取得ツールがクライアントのツール一覧に残り、誤ったタイミングで選択されることを防ぎます。

その他のインストール方法

プラグインとして

plugin/ ディレクトリには、Claude Code、Codex、RK が共通して使う形式のプラグインが含まれています。このプラグインは最新リリースの uvx reddit-rss-mcp を実行します。このリポジトリを Claude Code で開いたときにサーバーの起動を促すことがないよう、リポジトリのルートではなくサブディレクトリにあります。RK の組み込みマーケットプレイスには登録済みです。また、任意のマーケットプレイスで git-subdir ソースを使って登録できます：

{ "name": "reddit", "source": { "source": "git-subdir", "url": "jorgen-k/reddit-mcp", "path": "plugin" } }

GitHub から（最新の main、クローン不要）

未リリースの変更を実行するには、uvx にリポジトリと reddit-rss-mcp エントリーポイントを指定します。main の追跡ではなくリリースに固定するには、@vX.Y.Z（または任意のタグ）を追加します：

claude mcp add reddit --scope user -- uvx --from git+https://github.com/jorgen-k/reddit-mcp reddit-rss-mcp
codex mcp add reddit -- uvx --from git+https://github.com/jorgen-k/reddit-mcp reddit-rss-mcp

ローカルクローンから

コードを編集する場合は、こちらをおすすめします：

git clone https://github.com/jorgen-k/reddit-mcp.git
cd reddit-mcp
claude mcp add reddit --scope user -- uv --directory "$(pwd)" run server.py
codex mcp add reddit -- uv --directory "$(pwd)" run server.py

Claude Desktop では、上記と同じ設定ファイルを使い、which uv と pwd の絶対パスを指定します：

{
  "mcpServers": {
    "reddit": {
      "command": "/absolute/path/to/uv",
      "args": ["--directory", "/absolute/path/to/reddit-mcp", "run", "server.py"]
    }
  }
}

コード変更後の更新

サーバーはクライアントの接続時に一度だけ起動する、長時間実行プロセスです。server.py を編集してもホットリロードされません。実行中のプロセスは、再起動するまで古いコードを使い続けます。

• Claude Code： /mcp を実行し、reddit を選択して再接続します（または Claude Code を再起動します）。
• Codex CLI： 新しい Codex セッションを開始します。codex mcp list を実行して、設定済みのサーバーを確認します。
• ChatGPT Desktop： Settings → MCP servers で Restart を選択するか、アプリを終了して再起動します。
• Claude Desktop または Cowork： アプリを完全に終了（Cmd+Q）して、再起動します。

知っておきたい制限

読み取り専用で、公開コンテンツのみを扱います。公開フィードであることを踏まえ、リクエスト量には配慮してください。

スコア、投票数、コメント数は取得できません。 RSS には含まれていないためです。これらを取得するには Reddit の Data API が必要ですが、現在はモデレーション用途であることと承認が必要です。

レート制限。 Reddit は、認証なしの RSS に厳しいスロットリングを適用します。HTTP 429 が返された場合、サーバーはバックオフしながら再試行します。Retry-After ヘッダーがあればそれに従い、なければ約 2、4、8、16、32、64、128 秒（ジッターを加算）待機して、最大 7 回再試行します。また、最初から制限に抵触しないよう、送信リクエストの間に最低限の間隔を設けています。この設定はすべてのツールで共有されます。

検索の精度は Reddit の検索機能に左右されます。 search_reddit は Reddit 独自の検索エンジンを使用します。RSS は出力形式にすぎないため、結果は別の低性能なインデックスではなく、ウェブサイト上の検索結果と一致します。ただし、検索エンジンには実際の制限があります：

• コメント本文は検索されず、投稿のタイトルと本文（およびコミュニティ名）のみが対象です。 コメントにしか登場しない用語は見つかりません。
• 新しい投稿の反映には時間がかかります。 インデックス作成は即時ではありません。新着投稿を確実に見つけるには、browse_subreddit(sort="new") を使ってください。
• すべての結果が網羅されるわけではありません。 関連性の低い結果は除外されたり、下位に表示されたりします。

そのため、「結果なし」は Reddit の検索で見つからなかったという意味であり、投稿されたことがないという意味ではありません。

ライセンス

MIT。LICENSE を参照してください。