Reddit 콘텐츠 API

Reddit 콘텐츠 API - 설정 및 사용 가이드

이 프로젝트는 Claude와 Cursor를 통해 Reddit과 상호작용하기 위한 MCP(Model Context Protocol) 도구를 제공합니다.

특징

서브레딧의 인기 게시물 읽기
댓글이 포함된 Reddit 토론 분석
Reddit에 게시물 작성
게시물에 댓글 추가 또는 기존 댓글에 답변
게시물 및 댓글에 투표하기

요구 사항

파이썬 3.10+
Reddit 계정
등록된 Reddit 애플리케이션(client_id 및 client_secret을 얻기 위해)
가상 환경(venv 또는 유사)
Claude Desktop 및/또는 Cursor(선택 사항이지만 권장)

처음부터 설치

가져오기 및 구성 문제를 방지하려면 다음 단계를 주의 깊게 따르세요.

지엑스피1

⚠️ 중요 : 편집 가능한 모드( pip install -e . )로 패키지를 설치하지 마세요. 모듈 가져오기 문제가 발생할 수 있습니다.

환경 구성

프로젝트 루트에 다음 변수를 사용하여 .env 파일을 만듭니다.

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_client_secret
REDDIT_REFRESH_TOKEN=your_refresh_token

새로 고침 토큰을 얻으려면 다음을 실행하세요.

python -m mcp_reddit.auth_helper

안내에 따라 애플리케이션을 승인하세요. 토큰은 .env 파일에 자동으로 저장됩니다.

프로젝트 구조

mcp-reddit/
│
├── src/
│   └── mcp_reddit/
│       ├── __init__.py
│       ├── main.py           # Entry point for the MCP server
│       ├── reddit_fetcher.py # Implementation of Reddit tools
│       └── auth_helper.py    # Helper for generating authentication tokens
│
├── .env                      # Environment variables (create manually)
├── requirements.txt
├── setup.py
└── README.md

서버를 직접 실행

수동으로 실행하려면(개발 및 테스트에 유용함):

cd /path/to/mcp-reddit
.venv/bin/python src/mcp_reddit/main.py

다음을 나타내는 로그가 표시되어야 합니다.

서버 초기화
Reddit 인증 확인
도구 10개 등록 (원래 도구 5개 + 접두사 도구 5개)
"MCP 서버 실행 중..."

클로드 데스크톱 구성

구성 파일을 찾으세요.
- macOS의 경우: /Users/your-username/Library/Application Support/Claude/claude_desktop_config.json
- Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json
reddit-content-api에 대한 구성을 추가합니다.

"reddit-content-api": {
  "command": "/full/path/to/mcp-reddit/.venv/bin/python",
  "args": [
    "-m",
    "mcp_reddit.main",
    "--stdio"
  ],
  "cwd": "/full/path/to/mcp-reddit",
  "env": {
    "PYTHONPATH": "/full/path/to/mcp-reddit/src:/full/path/to/mcp-reddit",
    "DEBUG": "true"
  }
}

⚠️ 매우 중요 : PYTHONPATH src 디렉터리와 프로젝트 루트가 모두 포함되어야 하며, 각 항목은 Unix/macOS에서는 : , Windows에서는 ; 로 구분해야 합니다.

커서 구성

구성 파일을 찾으세요.
- macOS의 경우: /Users/your-username/.cursor/mcp.json
- Windows의 경우: %USERPROFILE%\.cursor\mcp.json
Claude와 동일한 구성을 추가하고 필요에 따라 경로를 조정합니다.

일반적인 문제 해결

문제: 예상했던 10개 대신 2개의 도구만 나타납니다.

증상 : 서버를 실행하면 예상한 10개 대신 2개의 도구만 나타납니다.

가능한 원인과 해결책 :

가져오기 문제 : Python은 src/ 의 로컬 코드 대신 site-packages 에서 설치된 버전을 가져옵니다.해결책 :
- 편집 가능한 모드( pip install -e .
- 구성에서 PYTHONPATH 의 시작 부분에 src 명시적으로 추가합니다.
- 이미 설치했다면 pip uninstall reddit-content-api 사용하여 제거하세요.
Python 캐시 : 오래된 .pyc 파일로 인해 문제가 발생할 수 있습니다.해결책 :
- 프로젝트에서 모든 __pycache__ 디렉토리를 제거합니다.
버전 충돌 : 동일한 라이브러리의 서로 다른 버전.해결책 :
- pip install -r requirements.txt 로 종속성을 다시 설치합니다.

문제: "게시물을 생성할 수 없습니다. Reddit 인증이 제대로 구성되지 않았습니다."

원인 : 새로 고침 토큰이 잘못되었거나 만료되었습니다.

해결 방법 : python -m mcp_reddit.auth_helper 실행하여 토큰을 다시 생성하고 .env 에 저장되었는지 확인하세요.

문제: 도구가 Claude/Cursor에 나타나지 않습니다.

원인 : 구성 파일의 구성이 잘못되었습니다.

해결책 :

구성 파일에서 경로, 특히 PYTHONPATH 확인하세요.
구성을 수정한 후 Claude/Cursor를 완전히 다시 시작하세요.

Claude/Cursor의 도구 사용

구성이 완료되면 다음 도구를 사용할 수 있습니다.

mcp_reddit_content_api_fetch_reddit_hot_threads - 인기 게시물 받기
mcp_reddit_content_api_fetch_reddit_post_content - 게시물과 댓글 분석
mcp_reddit_content_api_create_reddit_post - 새 게시물 만들기
mcp_reddit_content_api_add_reddit_comment - 댓글 추가
mcp_reddit_content_api_vote_on_reddit_content - 콘텐츠에 투표

예시

트렌드 게시물 얻기 :

Subreddit: python
Number of posts: 5

게시물 만들기 :

Subreddit: test
Title: Test from MCP
Content type: text
Content: This is a test from the Reddit Content API using MCP.

기여

문제가 발견되거나 개선할 사항이 있으면 문제를 생성하거나 풀 리퀘스트를 제출하세요.

특허

MIT

이 프로젝트를 지원하세요

이 프로젝트가 여러분의 업무나 연구에 유용하다고 생각된다면, 다음 사항을 고려해 보세요.

⭐ 저장소에 별표를 표시하여 지원을 표시하세요
🔄 새로운 기능 및 개선 사항에 대한 업데이트를 위해 저장소를 팔로우하세요
🐛 버그 또는 기능 요청에 대한 이슈 공개
🛠️ 공유할 개선 사항이 있는 경우 풀 리퀘스트를 통해 기여하세요.

여러분의 후원은 이 프로젝트를 모든 사람을 위해 더 나은 곳으로 만드는 데 큰 도움이 됩니다!

Reddit Content API

Integrations