Reddit Summarizer MCP Server

1# Reddit Summarizer MCP Server
2A Model Context Protocol (MCP) server for summarizing homepage of the user or contents of subreddits and comments on posts.
3## Features
4- Summarize user's reddit frontpage (homepage) with or without comment analyses.
5- Summarize a subreddit contents by inspecting posts sorted by hot, new, top, rising, random (if aviable) with or without comment analysis.
6- Summarize comments on a post.
7## Requirements
8- Python 3.12 or higher
9- uv package manager (recommended)
10- Reddit API credentials
11- MCP client (e.g. Claude Desktop)
12## Installation
13Clone repository or download files manually.
14```bash
15git clone https://github.com/sinanefeozler/reddit-summarizer-mcp.git
16cd reddit-summarizer-mcp
17```
18Create virtual envoriment and install dependencies.
19```bash
20uv venv
21source .venv/bin/activate
22uv sync
23```
24### Setting Up The Envoriment Variables
25- This server needs reddit username, password and reddit authentication.
26- You can get client id and client secret by following [these steps](https://github.com/reddit-archive/reddit/wiki/OAuth2-Quick-Start-Example#first-steps)
27- When you get the required keys create .env file according to .env.example
28For claude desktop client users check out this [link](https://modelcontextprotocol.io/quickstart/user) to setup the server.
29## Available Tools
30### `summarize_frontpage`
31Summarize user's homepage with post limits and optional comment analyse on posts.
32Parameters:
33- `limit` (default: 10): Post fetching limit
34- `with_comments` (default: false): Summarize with comments on posts
35### `summarize_subreddit`
36Summarize a subreddit's contents by inspecting posts.
37Parameters:
38- `limit` (default: 10): Post fetching limit
39- `with_comments` (default: false): Summarize with comments on posts
40- `fetch_by` (default: 'hot') : Sorting option for posts. (hot, new, top, rising, random if aviable)
41### `reed_comments`
42Reed and summarize comments on a post. Needs post id or url.
43Parameters:
44- `id` (default: None) : id of post
45- `url` (default: None) : url of post
46- `limit` (default: 15) : fetching limit of the comments
47## Prompts
48### Example Prompts:
49- "Summarize my reddit frontpage with comment analyse for deeper understanding of public opinion"
50- "Summarize the hot post of Politics"
51### Prompt Template:
52#### `/summarize_my_page`
53Provides 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.
54## License
55MIT