MCP Reddit

🚀 MCP Reddit サーバー

このプロジェクトは、MCP（モデルコンテキストプロトコル）プロトコルに基づくRedditサーバーで、Claudeなどの大規模言語モデルとのインタラクションを目的として設計されています。このサービスを通じて、AIアシスタントにReddit上のコンテンツの閲覧や分析を依頼することができます。

English | 中文説明

🚀 クイックスタート

このMCP Redditサーバーを使うことで、Claudeなどの大規模言語モデルと連携してRedditのコンテンツを効率的に扱えます。以下の手順に従ってサーバーをセットアップしてください。

✨ 主な機能

• 特定のsubreddit内の投稿を検索します。
• 投稿の詳細情報とコメントを取得します。
• subreddit内の人気の投稿を閲覧します。

📦 インストール

前提条件

• Docker（必須）
• Python 3.12+（ローカル開発用）
• Reddit APIの認証情報（必須）

Reddit APIの認証情報の取得

1. https://www.reddit.com/prefs/apps にアクセスします。
2. "create another app..." をクリックします。
3. "script" を選択します。
4. 必要事項を入力します。
5. client_id と client_secret を取得します。

環境変数の設定

以下の環境変数を設定する必要があります。

REDDIT_CLIENT_ID=あなたのclient_id
REDDIT_CLIENT_SECRET=あなたのclient_secret
REDDIT_USER_AGENT=あなたのuser_agent

Dockerによるインストール

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

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

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

3. Dockerイメージをビルドします。

   docker build -t mcp-reddit .
   

4. コンテナを実行します。

   docker run -i --rm \
     -e REDDIT_CLIENT_ID=あなたのclient_id \
     -e REDDIT_CLIENT_SECRET=あなたのclient_secret \
     -e REDDIT_USER_AGENT=あなたのuser_agent \
     mcp-reddit
   

💻 使用例

基本的な使用法

サーバーのセットアップ

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

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

2. 依存関係をインストールします。

pip install -r requirements.txt

3. サーバーを起動します。

python src/server.py

📚 ドキュメント

注意事項

セキュリティ

• Reddit APIの認証情報を適切に保管してください。
• 設定ファイルを公共の場で共有しないでください。
• 環境変数を使用して認証情報を設定することをおすすめします。

使用制限

• Reddit APIには呼び出し頻度の制限があります。
• デフォルトでは返されるコメントの数は10件に制限されています。
• 検索結果はデフォルトで5件に制限されています。

トラブルシューティング

• APIの認証情報が正しいか確認してください。
• ネットワーク接続が正常であることを確認してください。
• ログ出力を確認して詳細なエラー情報を取得してください。

貢献ガイド

1. プロジェクトをForkします。
2. 新しい機能ブランチを作成します (git checkout -b feature/AmazingFeature)。
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')。
4. ブランチにプッシュします (git push origin feature/AmazingFeature)。
5. Pull Requestを作成します。

📄 ライセンス

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

🔧 技術詳細

プロジェクト構造

nangeAGICode/reddit_chat_claude/
├── .github/
│   └── workflows/
│       └── docker.yml # GitHub Actionsのワークフロー設定
├── src/
│   ├── init.py
│   └── server.py # MCPサーバーの核心コード
├── .gitignore # Gitの無視ファイル設定
├── Dockerfile # Dockerのビルドファイル
├── LICENSE # MITライセンス
├── README.md # プロジェクトの説明ドキュメント
└── requirements.txt # Pythonの依存パッケージリスト