Reddit MCP 서버

Claude(및 기타 MCP 클라이언트)가 Reddit 게시물과 댓글을 검색하고 읽을 수 있게 해주는 MCP 서버입니다.

도구

Related MCP server: reddit-mcp

설정

npm install
npm run build

Node.js 18 이상이 필요합니다.

이 서버는 Reddit의 공개 JSON 엔드포인트를 사용하며 Reddit API 자격 증명이 필요하지 않습니다.

Claude Desktop 구성

Claude Desktop 구성 파일에 추가하세요(macOS/Linux: ~/.config/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "reddit": {
      "command": "node",
      "args": ["/absolute/path/to/reddit-mcp/dist/server.js"]
    }
  }
}

예시 경로를 이 저장소를 클론한 경로로 바꾸세요.

VS Code MCP 구성

VS Code 설정(.vscode/mcp.json)에 추가하세요:

{
  "servers": {
    "reddit": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/dist/server.js"]
    }
  }
}

저장소 워크스페이스 외부에서 구성할 때는 ${workspaceFolder}를 클론한 저장소의 절대 경로로 바꾸세요.

사용 예시

연결되면 Claude는 다음 도구를 사용할 수 있습니다:

• 서브레딧 스캔: "이번 주 r/programming의 상위 20개 게시물을 보여줘"

• 게시물 검색: "Reddit에서 'MCP server tutorial'을 검색해줘"

• 게시물 세부 정보: "첫 번째 게시물의 댓글을 가져와줘"

아키텍처

• src/server.ts — MCP 서버 진입점, 도구 등록, stdio 전송

• src/tools/ — 입력 검증이 포함된 개별 도구 핸들러

• src/reddit/ — 공급자 추상화가 포함된 Reddit 데이터 클라이언트

• src/reddit/providers/publicJson.ts — 공개 JSON 엔드포인트 공급자(MVP)

• src/core/ — 공유 타입, 검증, 오류 분류 체계

• src/tests/ — 캐싱 및 댓글 중복 제거를 위한 단위 테스트

공급자 인터페이스(RedditProvider)를 사용하면 도구 코드를 변경하지 않고도 나중에 Reddit OAuth API로 쉽게 전환할 수 있습니다.