MCP-Discord

MCP-디스코드

AI 어시스턴트가 Discord 플랫폼과 상호 작용할 수 있도록 하는 Discord MCP(Model Context Protocol) 서버입니다.

개요

MCP-Discord는 다음과 같은 Discord 관련 기능을 제공합니다.

• Discord 봇에 로그인하세요
• 서버 정보 가져오기
• 채널 메시지 읽기/삭제
• 지정된 채널로 메시지 보내기
• 포럼 채널 목록 검색
• 포럼 게시물 작성/삭제/답글 작성
• 텍스트 채널 생성/삭제
• 메시지 반응 추가/제거
• 웹훅 생성/편집/삭제/사용

목차

• 필수 조건
• 설치
• 구성
• 도구 문서
  • 기본 기능
  • 채널 관리
  • 포럼 기능
  • 메시지 및 반응
  • 웹훅 관리
• 개발
• 특허

필수 조건

• Node.js(v16.0.0 이상)
• npm(v7.0.0 이상)
• 적절한 권한이 있는 Discord 봇
  • 봇 토큰( Discord 개발자 포털 에서 획득 가능)
  • 메시지 콘텐츠 의도 활성화됨
  • 서버 멤버 인텐트 활성화됨
  • 현재 의도 활성화됨
• Discord 서버의 권한:
  • 메시지 보내기
  • 공개 스레드 만들기
  • 스레드에서 메시지 보내기
  • 스레드 관리
  • 채널 관리
  • 반응 추가

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 mcp-discord를 자동으로 설치하려면:

지엑스피1

수동 설치

구성

Discord 봇이 정상적으로 작동하려면 토큰이 필요합니다. 토큰은 두 가지 방법으로 제공하실 수 있습니다.

1. 환경 변수:

2. 실행할 때 --config 매개변수를 사용합니다.

향상된 시작 스크립트

이 프로젝트에는 더 나은 디버깅 및 오류 처리를 제공하는 향상된 시작 스크립트( start-discord.js )가 포함되어 있습니다.

• .env 파일에서 환경 변수를 로드합니다.
• 제공되지 않으면 기본 서버 및 채널 ID를 설정합니다.
• Claude Desktop에서 JSON 구문 분석 문제를 방지하기 위해 console.log를 stderr로 리디렉션합니다.
• MCP 서버를 시작하기 전에 Discord 연결을 직접 테스트합니다.
• 문제가 발생하면 자세한 오류 정보를 제공합니다.

이 스크립트를 사용하려면:

Claude/Cursor와 함께 사용

• 클로드
  { "mcpServers": { "discord": { "command": "node", "args": [ "path/to/mcp-discord/start-discord.js" ], "env": { "DISCORD_TOKEN": "your_discord_bot_token", "DEFAULT_SERVER_ID": "your_default_server_id", "DEFAULT_CHANNEL_ID": "your_default_channel_id" } } } }
• 커서
  { "mcpServers": { "discord": { "command": "cmd", "args": [ "/c", "node", "path/to/mcp-discord/start-discord.js" ], "env": { "DISCORD_TOKEN": "your_discord_bot_token", "DEFAULT_SERVER_ID": "your_default_server_id", "DEFAULT_CHANNEL_ID": "your_default_channel_id" } } } }

도구 문서

기본 기능

• discord_login : Discord에 로그인
• discord_list_guilds : 사용 가능한 모든 Discord 서버(길드)와 채널을 나열합니다.
• discord_send : 지정된 채널로 메시지를 보냅니다.
• discord_get_server_info : Discord 서버 정보 가져오기

채널 관리

• discord_create_text_channel : 텍스트 채널 만들기
• discord_delete_channel : 채널 삭제

포럼 기능

• discord_get_forum_channels : 포럼 채널 목록을 가져옵니다.
• discord_create_forum_post : 포럼 게시물을 만듭니다
• discord_get_forum_post : 포럼 게시물 받기
• discord_reply_to_forum : 포럼 게시물에 답변하기
• discord_delete_forum_post : 포럼 게시물 삭제

메시지 및 반응

• discord_read_messages : 채널 메시지 읽기
• discord_add_reaction : 메시지에 반응 추가
• discord_add_multiple_reactions : 메시지에 여러 반응을 추가합니다.
• discord_remove_reaction : 메시지에서 반응을 제거합니다.
• discord_delete_message : 채널에서 특정 메시지를 삭제합니다.

웹훅 관리

• discord_create_webhook : Discord 채널에 대한 새로운 웹훅을 생성합니다.
• discord_send_webhook_message : 웹훅을 사용하여 Discord 채널에 메시지를 보냅니다.
• discord_edit_webhook : Discord 채널의 기존 웹훅을 편집합니다.
• discord_delete_webhook : Discord 채널의 기존 웹훅을 삭제합니다.

개발

특허

MIT 라이센스