Reddit Summarizer MCP Server
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. ``bash git clone https://github.com/sinanefeozler/reddit-summarizer-mcp.git cd reddit-summarizer-mcp ` Create virtual envoriment and install dependencies. `bash 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 limitwith_comments(default: false): Summarize with comments on posts
summarize_subreddit
Summarize a subreddit's contents by inspecting posts. Parameters:
limit(default: 10): Post fetching limitwith_comments(default: false): Summarize with comments on postsfetch_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 posturl(default: None) : url of postlimit(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
