sinanefeozler/reddit-summarizer-mcp

A Model Context Protocol (MCP) server for summarizing homepage of the user or contents of subreddits and comments on posts.

Features

• Summarize user's reddit frontpage (homepage) with or without comment analyses.
• Summarize a subreddit contents by inspecting posts sorted by hot, new, top, rising, random (if aviable) with or without comment analysis.
• Summarize comments on a post.

Requirements

• Python 3.12 or higher
• uv package manager (recommended)
• Reddit API credentials
• MCP client (e.g. Claude Desktop)

Installation

Clone repository or download files manually.

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

Create virtual envoriment and install dependencies.

uv venv
source .venv/bin/activate
uv sync

Setting Up The Envoriment Variables

• This server needs reddit username, password and reddit authentication.
• You can get client id and client secret by following these steps
• When you get the required keys create .env file according to .env.example For claude desktop client users check out this link to setup the server.

Available Tools

summarize_frontpage

Summarize user's homepage with post limits and optional comment analyse on posts. Parameters:

• limit (default: 10): Post fetching limit
• with_comments (default: false): Summarize with comments on posts

summarize_subreddit

Summarize a subreddit's contents by inspecting posts. Parameters:

• limit (default: 10): Post fetching limit
• with_comments (default: false): Summarize with comments on posts
• fetch_by (default: 'hot') : Sorting option for posts. (hot, new, top, rising, random if aviable)

reed_comments

Reed and summarize comments on a post. Needs post id or url. Parameters:

• id (default: None) : id of post
• url (default: None) : url of post
• limit (default: 15) : fetching limit of the comments

Prompts

Example Prompts:

• "Summarize my reddit frontpage with comment analyse for deeper understanding of public opinion"
• "Summarize the hot post of Politics"

Prompt Template:

/summarize_my_page

Provides a prompt to summarize and categorize the posts and comments on frontpage. Gives LLM a predefined template and categorize to make a more human readable outputs.

License

MIT