Reddit Buddy MCP

🚀 🤖 Reddit MCP Buddy

Reddit MCP Buddyは、Claude Desktopや他のAIアシスタントがRedditを閲覧し、投稿を検索し、ユーザーの活動を分析できるようにするModel Context Protocol (MCP)サーバーです。クリーンで高速で、実際に動作します。APIキーは不要です。

🚀 クイックスタート

Claude Desktopの場合

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-buddy"]
    }
  }
}

これで完了です！Reddit MCP BuddyがClaudeで利用可能になりました。

✨ 主な機能

• 🚀 ゼロセットアップ - すぐに動作し、Reddit APIの登録は不要です。
• ⚡ 最大10倍のリクエスト - オプションの認証により、レート制限を増やすことができます。
• 🎯 クリーンなデータ - 偽の「センチメント分析」や作り上げたメトリクスはありません。
• 🧠 LLM最適化 - ClaudeのようなAIアシスタント向けに特別に構築されています。
• 📦 TypeScript - 完全に型付けされ、信頼性が高く、保守が容易です。

📦 インストール

テストと開発

対話型認証セットアップ（ローカルテストのみ）

ローカル開発とテストのために、対話形式で認証を設定できます。

npx reddit-buddy --auth

これにより、Redditアプリの資格情報が求められ、ローカルに保存されます。ただし、これはClaude Desktopでは動作しません。Claudeの設定で環境変数を使用してください。

HTTPモードでのテスト

ターミナルでサーバーを直接テストするには、次のコマンドを実行します。

# ポート3000でHTTPモードで実行
npx reddit-mcp-buddy --http

# またはカスタムポートで
REDDIT_BUDDY_PORT=8080 npx reddit-mcp-buddy --http

注: サーバーはデフォルトでstdioモード（Claude Desktop用）で実行されます。Postman MCPまたは直接のAPI呼び出しでテストするには、--httpフラグを使用してください。

グローバルインストール

npm install -g reddit-mcp-buddy
reddit-buddy --http  # テスト用

ソースからのインストール

git clone https://github.com/karanb192/reddit-mcp-buddy.git
cd reddit-mcp-buddy
npm install
npm run build
npm link

Dockerを使用する場合

docker run -it karanb192/reddit-mcp-buddy

💻 使用例

基本的な使用法

あなたのAIアシスタントに以下のような質問をすることができます。

"今日のGPT - 4に関するトップの投稿は何ですか？"

→ search_reddit with query="GPT-4", time="day", sort="top"

"テクノロジーのトレンドを見せて"

→ browse_subreddit with subreddit="technology", sort="hot"

"この記事について人々はどう思っていますか？"

→ search_reddit with the article URL to find discussions

"ユーザーDeepFuckingValueを分析して"

→ user_analysis with username="DeepFuckingValue"

"このRedditの投稿のコメントを取得して"

→ get_post_details with url="https://reddit.com/r/..."

"Reddit全体でトレンドになっているものは何ですか？"

→ browse_subreddit with subreddit="all", sort="hot"

📚 ドキュメント

利用可能なツール

browse_subreddit

任意のサブレディットの投稿をソートオプションで閲覧します。

- サブレディット:
  - "all" - Redditのフロントページ全体
  - "popular" - Reddit全体でトレンドになっているもの
  - 任意の特定のサブレディット（例: "technology", "programming", "science"）
- ソート方法: hot, new, top, rising, controversial
- 時間範囲: hour, day, week, month, year, all（top/controversialソートの場合）
- サブレディット情報の包含: サブレディットのメタデータを取得するためのオプションフラグ

search_reddit

Reddit全体または特定のサブレディットを検索します。

- クエリ: 検索用語
- フィルター: サブレディット、投稿者、時間、フレア
- ソート方法: 関連性、hot、top、new、コメント数

get_post_details

投稿とそのすべてのコメントを取得します。

- 入力:
  - RedditのURL（サブレディットを含む完全なURL）、または
  - 投稿IDのみ（自動的にサブレディットを検出します、2回のAPI呼び出し）、または
  - 投稿ID + サブレディット（最も効率的で、1回のAPI呼び出し）
- オプション: コメントのソート、深さ、リンクの抽出

user_analysis

Redditユーザーのプロファイルを分析します。

- ユーザー名: 任意のRedditユーザー
- 返される情報: カルマ、投稿、コメント、アクティブなサブレディット

reddit_explain

Redditの用語の説明を取得します。

- 用語: karma、cake day、AMA、ELI5など

認証（オプション）

より多くのリクエストを行いたい場合は、Claude Desktopの設定にRedditの資格情報を追加します。

セットアップ手順

1. https://www.reddit.com/prefs/apps にアクセスします。
2. アプリを作成します（タイプ: script - 重要！）。
3. 資格情報を見つけます。
   • クライアントID: "personal use script"の下に表示されます。
   • クライアントシークレット: アプリページのシークレット文字列。
4. Claude Desktopの設定を更新します。

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-buddy"],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_USERNAME": "your_username",
        "REDDIT_PASSWORD": "your_password"
      }
    }
  }
}

レート制限

• 認証なし: 10リクエスト/分（デフォルト）
• クライアントID + シークレットのみ: 60リクエスト/分
• ユーザー名 + パスワード付き: 100リクエスト/分

注: 最大レート制限（100リクエスト/分）を利用するには、ユーザー名とパスワードを含むすべての4つの資格情報が必要です。

他のツールとの比較

レート制限

なぜReddit MCP Buddyを選ぶべきか

他のツールの問題点

• ❌ 偽のメトリクス - キーワードカウントにすぎない「センチメントスコア」
• ❌ 複雑なセットアップ - 開始するだけでAPIキーが必要
• ❌ 肥大化したレスポンス - Redditの生のAPIの100以上のフィールドを返す
• ❌ 貧弱なLLM統合 - 混乱するパラメータと不明確な説明

当社のツールの良い点

• ✅ 実データのみ - RedditのAPIからのものでなければ、作り上げません。
• ✅ クリーンなレスポンス - 重要なフィールドのみ
• ✅ 明確なパラメータ - LLMが送信する内容を正確に理解できます。
• ✅ 高速かつキャッシュされる - 可能な限り即時のレスポンス

トラブルシューティング

一般的な問題

"Command not found"エラー

# npmがインストールされていることを確認
node --version
npm --version

# 完全なnpxパスで試す
$(npm bin -g)/reddit-mcp-buddy

レート制限エラー

• 認証なし: 10リクエスト/分に制限
• アプリの資格情報のみ: 60リクエスト/分
• 完全な認証: 100リクエスト/分
• 解決策: Redditの資格情報を追加します（認証を参照）。

"Subreddit not found"

• スペルを確認します（大文字と小文字は区別されません）。
• 一部のサブレディットはプライベートまたは隔離されている場合があります。
• 代わりに"all"または"popular"を試してみてください。

接続問題

• Redditがダウンしている可能性があります（https://www.redditstatus.com を確認）。
• ファイアウォールがリクエストをブロックしている場合があります。
• MCPサーバーを再起動してみてください。

環境変数

認証用変数

サーバー構成

🔧 技術詳細

スマートキャッシュシステム

Reddit MCP Buddyには、パフォーマンスを向上させ、API呼び出しを減らすためのインテリジェントなキャッシュが含まれています。

• メモリ安全: 50MBのハード制限 - システムパフォーマンスに影響を与えません。
• 適応的TTL: 人気の投稿（5分）、新しい投稿（2分）、トップの投稿（30分）
• LRUエビクション: 制限に近づいたときに最も使用されていないデータを自動的に削除します。
• ヒット追跡: 実際の使用パターンに基づいてキャッシュを最適化します。 これにより、高速なレスポンスが得られ、Redditのレート制限内に収まり、最小限のシステムリソースを使用します。

開発

# 依存関係のインストール
npm install

# 開発モードで実行
npm run dev

# ビルド
npm run build

# テスト
npm test

# リント
npm run lint

# 型チェック
npm run typecheck

要件

• Node.js >= 18.0.0
• npmまたはyarn
• TypeScript 5.5+

コントリビュート

PRは大歓迎です！ガイドラインについてはCONTRIBUTING.mdを参照してください。 私たちはシンプルなことを重視しています。

• 偽の分析はありません。
• クリーンで型付けされたコード
• 明確なドキュメント
• 高速なレスポンス

サポート

• 🐛 バグ報告
• 💡 機能リクエスト
• ⭐ GitHubでスターをつける

📄 ライセンス

MIT - 自由に使用できます！

MCPコミュニティのために愛を込めて作られました。ベンチャーキャピタルもトラッキングもなく、ただ良いMCPサーバーです。