saseq/discord-mcp

📖 설명

Discord API용 모델 컨텍스트 프로토콜(MCP) 서버는 (JDA)를 사용합니다. Claude, ChatGPT 등 MCP 호환 애플리케이션과 디스코드 봇을 통합하도록 설계되었습니다. AI 어시스턴트가 상호작용할 수 있게 해줍니다 채널 관리, 메시지 전송, 서버 정보 조회를 통해 Discord를 활용합니다. 강력한 Discord 자동화와 AI 기반 워크플로우 구축에 이상적입니다.

🔬 설치

► 🐳 도커 설치 (권장)

[! 참고] Docker 설치가 필요합니다. 전체 설명은 docker.com 에서 확인할 수 있습니다.

1) 로컬 환경 변수 설정

[! 중요] 디스코드 봇 생성 및 토큰 조회 방법은 여기에서 확인할 수 있습니다.

[! 팁] DISCORD_GUILD_ID env 변수는 선택 사항입니다.

제공되면 기본 Discord 서버 ID를 설정하여 guildId 매개변수를 수락하는 도구는 이를 생략할 수 있습니다.

2) Docker 컨테이너를 실행합니다

기본 MCP 엔드포인트 URL (HTTP 프로필): http://localhost:8085/mcp

🐋 도커 컴포스트 설치

1) 저장소 복제

2) 프로젝트 디렉토리로 가세요

3) 로컬 런타임 환경 생성

4) 하나의 공유 MCP 서버 컨테이너를 시작한다

5) 검증

[! 팁]

📖 Description

A Model Context Protocol (MCP) server for the Discord API using (JDA), designed to integrate Discord bots with MCP-compatible applications such as Claude, ChatGPT etc. It allows AI assistants to interact with Discord by managing channels, sending messages, and retrieving server information. Ideal for building powerful Discord automation and AI-driven workflows.

🔬 Installation

► 🐳 Docker Installation (Recommended)

[!NOTE] Docker installation is required. Full instructions can be found on docker.com.

1) Set local env variables

export DISCORD_TOKEN="YOUR_DISCORD_BOT_TOKEN"
export DISCORD_GUILD_ID="OPTIONAL_DEFAULT_SERVER_ID"
export SPRING_PROFILES_ACTIVE=http

[!IMPORTANT] Instructions for creating a Discord bot and retrieving its token can be found here.

[!TIP] The DISCORD_GUILD_ID env variable is optional.

When provided, it sets a default Discord server ID so any tool that accepts a guildId parameter can omit it.

2) Run the Docker container

docker run -d -i \
  --name discord-mcp \
  --restart unless-stopped \
  -p 8085:8085 \
  -e SPRING_PROFILES_ACTIVE \
  -e DISCORD_TOKEN \
  -e DISCORD_GUILD_ID \
  saseq/discord-mcp:latest

Default MCP endpoint URL (HTTP profile): http://localhost:8085/mcp

1) Clone the repository

git clone https://github.com/SaseQ/discord-mcp

2) Go to the project directory

cd discord-mcp

3) Create local runtime env

cat > .env <<EOF
SPRING_PROFILES_ACTIVE=http
DISCORD_TOKEN=
DISCORD_GUILD_ID=
EOF

4) Start one shared MCP server container

docker compose up -d --build

5) Verify