Reddit MCP

🚀 Reddit MCP Server

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

📚 MCPとは何ですか？

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

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

✨ 主な機能

• エンゲージメント分析を含む詳細なユーザー情報を取得
• 任意のサブレディットのトップ投稿を取得し、分析
• 包括的なサブレディットの統計情報と健全性指標を取得
• 成長パターンを含むトレンドサブレディットを表示
• 投稿タイミングの推奨を含む戦略的な投稿を作成
• エンゲージメントを最適化した投稿やコメントへの返信
• AIによる洞察と推奨事項
• エンゲージメント指標を含むスマートなレスポンスの整形

📦 インストール

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

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

2. MCPサーバーに接続する

   以下のJSONを適切な{{PATH}}値でコピーします。

   {
     "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_config.jsonとして以下のClaude Desktopの設定ディレクトリに保存します。

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

   Cursorの場合、これをmcp.jsonとして以下のCursorの設定ディレクトリに保存します。

   ~/.cursor/mcp.json
   

3. Claude Desktop / Cursorを再起動する

   Claude Desktopを開くと、Redditが利用可能な統合として表示されるはずです。

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

利用可能なツール

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

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

• get_user_info(username) - エンゲージメントの洞察を含む詳細なユーザー分析を取得
• get_top_posts(subreddit, time_filter, limit) - トップ投稿を取得し、分析
• 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アクティビティを分析して"
• "今週のr/Pythonのトップ投稿を表示して"
• "r/AskRedditの統計情報を取得して"
• "現在トレンドのサブレディットは何ですか？"
• "r/Pythonに新しいプロジェクトについての投稿を作成して"
• "この投稿に洞察に富んだコメントで返信して"
• "このサブレディットで投稿する最適な時間はいつですか？"

🔧 高度な機能

AIによる分析

サーバーはいくつかの分野でインテリジェントな分析を提供します。

1. ユーザー分析

   • エンゲージメントパターン
   • アクティビティトレンド
   • コミュニティへの影響力
   • パーソナライズされた推奨事項

2. 投稿分析

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

3. コミュニティ分析

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

スマートなレスポンスの整形

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

🔑 認証

サーバーは2つのレベルの認証をサポートしています。

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

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

2. 認証済みアクセス

   • 必要なもの: すべての読み取り専用認証情報に加えて、usernameとpassword
   • 許可される操作: すべての読み取り専用操作に加えて、投稿とコメント

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

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