Этот репозиторий содержит реализацию сервера Model Context Protocol для Reddit, которая позволяет ассистентам ИИ получать доступ и взаимодействовать с контентом Reddit через PRAW (Python Reddit API Wrapper).

Что такое MCP?

Протокол контекста модели (MCP) — это стандарт, позволяющий ассистентам ИИ взаимодействовать с внешними сервисами, инструментами и источниками данных. Этот сервер реализует спецификацию MCP для обеспечения доступа к контенту Reddit.

Чтобы узнать больше о MCP, посмотрите это видео

Особенности

• Получить подробную информацию о пользователях с помощью анализа вовлечённости
• Получить историю комментариев и публикаций пользователей с помощью гибкой фильтрации
• Поиск и анализ лучших постов с любого сабреддита
• Поиск постов по всему Reddit или в отдельных сабреддитах с помощью поисковых запросов
• Получите подробную статистику сабреддита и показатели здоровья
• Просмотр трендовых сабреддитов с тенденциями роста
• Создавать стратегические посты с рекомендациями по времени
• Отвечать на посты и комментарии с оптимизацией вовлечённости
• Аналитика и рекомендации на основе ИИ
• Умное форматирование ответов с метриками вовлечённости

Установка

1. Клонировать это хранилище

2. Подключиться к серверу MCP

Reddit MCP Server

This repository contains a Model Context Protocol server implementation for Reddit that allows AI assistants to access and interact with Reddit content through PRAW (Python Reddit API Wrapper).

What is MCP?

The Model Context Protocol (MCP) is a standard for enabling AI assistants to interface with external services, tools, and data sources. This server implements the MCP specification to provide access to Reddit content.

To know more about MCP, Check this video

Features

• Get detailed user information with engagement analysis
• Retrieve user comment and post history with flexible filtering
• Fetch and analyze top posts from any subreddit
• Search for posts across all of Reddit or within specific subreddits using search terms
• Get comprehensive subreddit statistics and health metrics
• View trending subreddits with growth patterns
• Create strategic posts with timing recommendations
• Reply to posts and comments with engagement optimization
• AI-driven insights and recommendations
• Smart response formatting with engagement metrics

Installation

1. Clone this repository

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

2. Connect to the MCP server

   Copy the below json with the appropriate {{PATH}} values:

   {
     "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
         }
       }
     }
   }
   

   You can obtain Reddit API credentials by creating an app at Reddit’s app preferences page.

   For Claude, save this as claude_desktop_config.json in your Claude Desktop configuration directory at:

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

   For Cursor, save this as mcp.json in your Cursor configuration directory at:

   ~/.cursor/mcp.json
   

3. Restart Claude Desktop / Cursor

   Open Claude Desktop and you should now see Reddit as an available integration.

   Or restart Cursor.

Available Tools

The server provides the following tools:

Read-only Tools (require only client credentials):