Skip to main content
Glama
deenesjakoruzh
krishna-astrasols

Reddit MCP Server

by krishna-astrasols
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Reddit MCP Server

Reddit과 상호작용하기 위한 Model Context Protocol(MCP) 서버 - 게시물, 댓글, 사용자 정보를 가져오고 콘텐츠를 작성할 수 있습니다.

npm version npm downloads GitHub stars License: MIT

한눈에 보는 기능

기능

reddit-mcp-server

다른 Reddit MCP

게시물 작성

:white_check_mark:

:x:

게시물/댓글 답글

:white_check_mark:

:x:

게시물/댓글 수정

:white_check_mark:

:x:

게시물/댓글 삭제

:white_check_mark:

:x:

스팸 방지(세이프 모드)

:white_check_mark:

:x:

봇 공개 푸터

:white_check_mark:

:x:

정책 준수 기능 내장

:white_check_mark:

:x:

서브레딧 탐색

:white_check_mark:

:white_check_mark:

Reddit 검색

:white_check_mark:

:white_check_mark:

사용자 분석

:white_check_mark:

:white_check_mark:

게시물 댓글

:white_check_mark:

:white_check_mark:

설정 불필요 익명 모드

:white_check_mark:

:white_check_mark:

3단계 인증(10/60/100 rpm)

:white_check_mark:

:white_check_mark:

Related MCP server: Reddit MCP Server

빠른 시작

옵션 1: Claude Desktop 확장 프로그램(가장 간편함)

확장 프로그램 파일을 다운로드하여 열면 Claude Desktop이 자동으로 설치합니다:

reddit-mcp-server.mcpb 다운로드

옵션 2: NPX(설치 불필요)

npx reddit-mcp-server

또는 MCP 설정(Claude Desktop, Cursor 등)에 추가하세요:

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-server"]
    }
  }
}

옵션 3: Claude Code

claude mcp add --transport stdio reddit -- npx reddit-mcp-server

기능

읽기 전용 도구

도구

설명

get_reddit_post

참여도 분석과 함께 특정 Reddit 게시물 가져오기

get_top_posts

서브레딧 또는 홈 피드에서 인기 게시물 가져오기

browse_subreddit

정렬 기준(hot, new, top, rising, controversial)별로 서브레딧/홈 피드 탐색

get_user_info

Reddit 사용자에 대한 자세한 정보 가져오기

get_user_posts

특정 사용자가 작성한 게시물 가져오기

get_user_comments

특정 사용자가 작성한 댓글 가져오기

get_subreddit_info

서브레딧 세부 정보 및 통계 가져오기

get_trending_subreddits

현재 인기 있는 서브레딧 가져오기

get_post_comments

특정 게시물의 댓글을 스레드 구조로 가져오기

search_reddit

Reddit 전체에서 게시물 검색

쓰기 도구(사용자 자격 증명 필요)

도구

설명

create_post

서브레딧에 새 게시물 작성

reply_to_post

기존 게시물 또는 댓글에 답글 작성

edit_post

자신의 Reddit 게시물 수정(본문 텍스트만)

edit_comment

자신의 Reddit 댓글 수정

delete_post

자신의 게시물 영구 삭제

delete_comment

자신의 댓글 영구 삭제

설정

환경 변수

변수

필수

기본값

설명

REDDIT_CLIENT_ID

아니요*

-

Reddit 앱 클라이언트 ID

REDDIT_CLIENT_SECRET

아니요*

-

Reddit 앱 클라이언트 시크릿

REDDIT_USERNAME

아니요

-

Reddit 사용자 이름(쓰기 작업용)

REDDIT_PASSWORD

아니요

-

Reddit 비밀번호(쓰기 작업용)

REDDIT_USER_AGENT

아니요

자동 생성

사용자 지정 User-Agent 문자열

REDDIT_AUTH_MODE

아니요

auto

인증 모드: auto, authenticated, anonymous

REDDIT_SAFE_MODE

아니요

standard

쓰기 보호 장치: off, standard, strict

REDDIT_BOT_DISCLOSURE

아니요

off

봇 공개 푸터: auto, off

REDDIT_BOT_FOOTER

아니요

기본 제공

사용자 지정 봇 푸터 텍스트(공개 설정이 auto일 때)

REDDIT_CACHE

아니요

on

읽기 요청의 인메모리 캐싱: on, off

REDDIT_CACHE_MAX_MB

아니요

50

캐시 크기 상한(MB)(이를 초과하면 LRU로 제거)

REDDIT_MAX_RETRIES

아니요

3

HTTP 429 시 Retry-After 백오프를 사용한 재시도 횟수(0이면 비활성화)

*authenticated 모드를 사용할 때만 필요합니다.

전체 MCP 설정 예시

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["reddit-mcp-server"],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_USERNAME": "your_username",
        "REDDIT_PASSWORD": "your_password",
        "REDDIT_SAFE_MODE": "standard"
      }
    }
  }
}

세이프 모드(스팸 방지)

내장된 보호 장치로 스팸 감지 및 차단으로부터 Reddit 계정을 보호하세요. Reddit의 Responsible Builder Policy에 따라 기본적으로 활성화되어 있습니다(standard 모드).

세이프 모드를 사용해야 하는 이유는?

Reddit의 스팸 감지는 다음과 같은 행위에 대해 계정에 플래그를 지정할 수 있습니다:

  • 빠른 속도의 게시물 작성 또는 댓글 작성

  • 중복되거나 유사한 콘텐츠

  • 여러 서브레딧에 동일한 콘텐츠 게시

  • 비표준 User-Agent 문자열

세이프 모드는 이러한 문제를 자동으로 방지하는 데 도움이 됩니다.

모드 옵션

모드

쓰기 지연

중복 감지

사용 사례

off

없음

아니요

명시적 거부(opt-out) 전용

standard

2초

최근 10개 항목 + 교차 서브레딧

기본값, 권장

strict

5초

최근 20개 항목 + 교차 서브레딧

신중한 자동 게시용

세이프 모드 비활성화

세이프 모드는 기본적으로 활성화되어 있습니다. 명시적으로 비활성화하려면:

export REDDIT_SAFE_MODE=off
npx reddit-mcp-server

세이프 모드의 기능

  1. 속도 제한(Rate Limiting): 쓰기 작업 사이에 최소 지연 시간을 적용합니다.

  2. 중복 감지: 동일한 콘텐츠가 두 번 게시되지 않도록 차단합니다.

  3. 교차 서브레딧 감지: 동일한 콘텐츠를 여러 서브레딧에 게시하지 못하도록 방지합니다(Reddit 정책 준수).

  4. 스마트 User-Agent: 사용자 이름이 제공되면 Reddit 호환 User-Agent 형식을 자동 생성합니다.

봇 공개

Reddit의 Responsible Builder Policy는 봇이 자동화된 성격을 공개하도록 요구합니다. 모든 게시 콘텐츠에 자동 봇 푸터를 활성화하세요:

export REDDIT_BOT_DISCLOSURE=auto
npx reddit-mcp-server

활성화하면 모든 게시물, 답글, 수정 내용에 푸터가 추가됩니다:

---
🤖 I am a bot | Built with reddit-mcp-server

REDDIT_BOT_FOOTER로 푸터를 사용자 지정하세요:

export REDDIT_BOT_DISCLOSURE=auto
export REDDIT_BOT_FOOTER=$'\n\n---\n^(🤖 Custom bot footer text)'

인증 모드

모드 비교

모드

속도 제한

필요한 설정

적합한 용도

anonymous

~10 req/min

없음

빠른 테스트, 읽기 전용

auto (기본값)

10-100 req/min

선택 사항

유연한 사용

authenticated

60-100 req/min

필수

프로덕션 사용

익명 모드(설정 불필요)

{
  "env": {
    "REDDIT_AUTH_MODE": "anonymous"
  }
}

익명 모드는 모든 네트워크에서 작동하지 않습니다. Reddit은 많은 IP 대역(데이터센터, 클라우드 호스트, VPN, 그리고 자체적으로 플래그를 지정한 주소)에서의 인증되지 않은 요청을 차단하며 HTTP 403 차단 페이지로 응답합니다. 이 경우 도구는 다음과 같은 오류와 함께 실패합니다:

Reddit is blocking unauthenticated requests from this network (HTTP 403 with a
block page). Set REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET to authenticate with
OAuth, which also raises the rate limit from ~10 to 60+ requests/min.

해결 방법은 OAuth 자격 증명입니다 — 다음 섹션을 참조하세요. 이것은 Reddit 계정이나 요청한 서브레딧의 문제가 아니라 네트워크 자체의 특성이며, 따라서 모든 도구에 동시에 영향을 미칩니다. 다른 서브레딧은 정상인데 특정 서브레딧에서만 403이 발생한다면 이는 다른 문제입니다: 해당 서브레딧이 비공개이거나 검역(quarantine) 상태인 경우입니다.

인증 모드(더 높은 속도 제한)

  1. https://www.reddit.com/prefs/apps에서 Reddit 앱을 만듭니다("script" 유형 선택)

  2. 클라이언트 ID와 시크릿을 복사합니다

  3. 다음과 같이 설정합니다:

{
  "env": {
    "REDDIT_AUTH_MODE": "authenticated",
    "REDDIT_CLIENT_ID": "your_client_id",
    "REDDIT_CLIENT_SECRET": "your_client_secret"
  }
}

쓰기 작업

게시물을 작성, 답글, 수정 또는 삭제하려면 사용자 자격 증명이 필요합니다:

{
  "env": {
    "REDDIT_USERNAME": "your_username",
    "REDDIT_PASSWORD": "your_password",
    "REDDIT_SAFE_MODE": "standard"
  }
}

개발

명령어

pnpm install        # Install dependencies
pnpm build          # Build TypeScript
pnpm dev            # Build and run MCP inspector
pnpm test           # Run tests
pnpm lint           # Lint code
pnpm format         # Format code

CLI 옵션

npx reddit-mcp-server --version         # Show version
npx reddit-mcp-server --help            # Show help
npx reddit-mcp-server --generate-token  # Generate OAuth token for HTTP mode

HTTP 서버 모드

Docker 배포 또는 웹 기반 클라이언트의 경우 HTTP 전송을 사용하세요:

TRANSPORT_TYPE=httpStream PORT=3000 node dist/index.js

OAuth 보호 적용

export OAUTH_ENABLED=true
export OAUTH_TOKEN=$(npx reddit-mcp-server --generate-token | tail -1)
TRANSPORT_TYPE=httpStream node dist/index.js

인증된 요청을 보내세요:

curl -H "Authorization: Bearer $OAUTH_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"method":"tools/list","params":{}}' \
     http://localhost:3000/mcp

Docker

빠른 시작

# Pull and run
docker pull ghcr.io/jordanburke/reddit-mcp-server:latest

docker run -d \
  --name reddit-mcp \
  -p 3000:3000 \
  -e REDDIT_CLIENT_ID=your_client_id \
  -e REDDIT_CLIENT_SECRET=your_client_secret \
  -e REDDIT_SAFE_MODE=standard \
  ghcr.io/jordanburke/reddit-mcp-server:latest

Docker Compose

services:
  reddit-mcp:
    image: ghcr.io/jordanburke/reddit-mcp-server:latest
    ports:
      - "3000:3000"
    environment:
      - REDDIT_CLIENT_ID=${REDDIT_CLIENT_ID}
      - REDDIT_CLIENT_SECRET=${REDDIT_CLIENT_SECRET}
      - REDDIT_USERNAME=${REDDIT_USERNAME}
      - REDDIT_PASSWORD=${REDDIT_PASSWORD}
      - REDDIT_SAFE_MODE=standard
      - OAUTH_ENABLED=${OAUTH_ENABLED:-false}
      - OAUTH_TOKEN=${OAUTH_TOKEN}
    restart: unless-stopped

로컬에서 빌드

docker build -t reddit-mcp-server .
docker run -d --name reddit-mcp -p 3000:3000 --env-file .env reddit-mcp-server

Reddit Responsible Builder Policy

이 서버는 Reddit의 Responsible Builder Policy를 고려하여 설계되었습니다:

  • 세이프 모드 기본 활성화 — 속도 제한과 중복 감지로 스팸 방지

  • 교차 서브레딧 중복 감지 — 서브레딧 간 동일한 콘텐츠 차단

  • 봇 공개 지원 — 투명성을 위한 선택적 자동 푸터

  • 투표/카르마 조작 금지 — 추천/비추천 도구는 의도적으로 제외

  • 비공개 메시지 금지 — DM 도구는 의도적으로 제외

  • 정책 인지형 AI 지침 — MCP 서버 지침이 AI 어시스턴트에게 데이터 사용 제한을 상기시킴

크레딧

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Tools

View all tools

Related MCP Servers

  • Reddit MCP Server

    Arindam200
    A
    license
    A
    quality
    F
    maintenance
    An MCP server that enables AI assistants to access and interact with Reddit content through features like user analysis, post retrieval, subreddit statistics, and authenticated posting capabilities.
    15
    298
    MIT

  • reddit-mcp

    iris-alights
    A
    license
    B
    quality
    C
    maintenance
    An MCP server that provides both read-only and authenticated access to Reddit content and interactions without requiring a developer API key. It enables users to browse posts, search subreddits, and perform write actions like commenting and voting by leveraging browser session cookies.
    8
    1
    The Unlicense

  • threadr-mcp

    msaeedsakib
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides AI agents with full Reddit API capabilities including search, browsing, reading, posting, commenting, voting, editing, and deleting.
    10
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/krishna-astrasols/reddit-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server