Reddit Mcp Server

Reddit MCP Server

このリポジトリには、PRAW（Python Reddit API Wrapper）を通じて AI アシスタントが Reddit のコンテンツにアクセスし、操作できるようにする、Reddit 用 Model Context Protocol サーバーの実装が含まれています。

MCP とは？

Model Context Protocol（MCP）は、AI アシスタントが外部サービス、ツール、データソースと連携するための標準規格です。このサーバーは MCP 仕様を実装し、Reddit コンテンツへのアクセスを提供します。

MCP について詳しくは、こちらの動画をご覧ください。

機能

• エンゲージメント分析を含む詳細なユーザー情報を取得
• 柔軟なフィルタリングでユーザーのコメント履歴と投稿履歴を取得
• 任意のサブレディットからトップ投稿を取得して分析
• 検索語を使って Reddit 全体または特定のサブレディット内の投稿を検索
• サブレディットの包括的な統計情報と健全性指標を取得
• 成長傾向とともにトレンドのサブレディットを表示
• 投稿に最適なタイミングの推奨を含む、戦略的な投稿を作成
• エンゲージメントの最適化を考慮して投稿やコメントに返信
• AI 主導のインサイトと推奨事項
• エンゲージメント指標を含むスマートな返信フォーマット

インストール

1. このリポジトリをクローンします

git clone https://github.com/Arindam200/reddit-mcp.git
cd reddit-mcp

2. MCP サーバーに接続します

   適切な {{PATH}} の値を指定して、以下の json をコピーします。

   {
     "mcpServers": {
       "reddit": {
         "command": "{{PATH_TO_UV}}", // Run `which uv` and place the output here
         "args": [
           "--directory",
           "{{PATH_TO_SRC}}", // cd into the repo, run `pwd` and enter the output here
           "run",
           "server.py"
         ],
         "env": {
           "REDDIT_CLIENT_ID": "your_client_id",
           "REDDIT_CLIENT_SECRET": "your_client_secret",
           "REDDIT_USERNAME": "your_username", // Optional for authenticated operations
           "REDDIT_PASSWORD": "your_password" // Optional for authenticated operations
         }
       }
     }
   }
   

   Reddit API の認証情報は、Reddit のアプリ設定ページでアプリを作成すると取得できます。

   Claude の場合は、以下の場所にある Claude Desktop の設定ディレクトリに claude_desktop_config.json として保存します。

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

   Cursor の場合は、以下の場所にある Cursor の設定ディレクトリに mcp.json として保存します。

   ~/.cursor/mcp.json
   

3. Claude Desktop / Cursor を再起動します

   Claude Desktop を開くと、利用可能な連携機能として Reddit が表示されます。

   または、Cursor を再起動します。

利用可能なツール

サーバーは以下のツールを提供します。

読み取り専用ツール（クライアントの認証情報のみ必要）：

• get_user_info(username) - エンゲージメントに関するインサイトを含む、詳細なユーザー分析を取得
• get_user_comments(username, sort, time_filter, limit) - フィルタリングオプションを使って、ユーザーのコメント履歴を取得
• get_user_posts(username, sort, time_filter, limit) - フィルタリングオプションを使って、ユーザーの投稿／サブミッション履歴を取得
• get_top_posts(subreddit, time_filter, limit) - トップ投稿を取得して分析
• search_posts(query, subreddit, sort, time_filter, limit) - Reddit 全体または特定のサブレディット内の投稿を検索
• get_subreddit_stats(subreddit) - サブレディットの包括的な分析を取得
• get_trending_subreddits() - トレンドのサブレディット一覧を取得
• get_submission_by_url(url) - URL で Reddit のサブミッションを取得
• get_submission_by_id(submission_id) - ID で Reddit のサブミッションを取得

認証済みツール（ユーザーの認証情報が必要）：

• who_am_i() - 現在認証されているユーザーの情報を取得
• create_post(subreddit, title, content, flair, is_self) - 最適化された投稿を作成
• reply_to_post(post_id, content, subreddit) - エンゲージメントに関するインサイトを含む返信を追加
• reply_to_comment(comment_id, content, subreddit) - 戦略的な返信を追加

クエリの例

このサーバーに接続した AI アシスタントに、次のようなことを尋ねられます。

• 「Reddit での自分のユーザー名は何ですか？」または「自分の Reddit プロフィールを表示して」
• 「u/spez の Reddit での活動を分析して」
• 「u/spez の最近のコメントを表示して」
• 「過去 1 年間の u/poem_for_your_sprog の人気投稿を取得して」
• 「u/username の最も議論を呼んだコメントを表示して」
• 「今週の r/Python の人気投稿を表示して」
• 「Reddit 全体で『machine learning』に関する投稿を検索して」
• 「今月の r/learnprogramming で『beginner tutorials』に関する投稿を探して」
• 「r/AskReddit の統計を取得して」
• 「現在、人気上昇中のサブレディットは何ですか？」
• 「新しいプロジェクトについて r/Python に投稿を作成して」
• 「この投稿に、洞察に富んだコメントで返信して」
• 「このサブレディットに投稿するのに最適な時間はいつですか？」

高度な機能

AI による分析

サーバーは、次の複数の分野で高度な分析を提供します。

1. ユーザー分析

   • エンゲージメントのパターン
   • アクティビティの傾向
   • コミュニティへの影響力
   • パーソナライズされたおすすめ

2. 投稿分析

   • パフォーマンス指標
   • エンゲージメントの質
   • 投稿タイミングの最適化
   • コンテンツの影響評価

3. コミュニティ分析

   • 健全性の指標
   • 成長パターン
   • アクティビティ指標
   • エンゲージメントの機会

スマートな回答形式

• 整理された箇条書き
• エンゲージメント統計
• AI による洞察
• 戦略的な提案
• パフォーマンス指標

認証

サーバーは 2 段階の認証に対応しています。

1. 読み取り専用アクセス

   • 必要なもの：client_id と client_secret
   • 可能な操作：公開データの取得、投稿やコメントの閲覧

2. 認証済みアクセス

   • 必要なもの：読み取り専用アクセスのすべての認証情報に加えて、username と password
   • 可能な操作：読み取り専用のすべての操作に加えて、投稿とコメント

コントリビュート

コントリビュートを歓迎します！お気軽にプルリクエストをお送りください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。