Discord Community MCP

로컬 우선(local-first) 방식의 Model Context Protocol 서버입니다. 봇 계정을 통해 AI 에이전트가 읽기 전용으로 Discord 검색, 대화 찾기, 커뮤니티 조사, 성장 분석을 수행할 수 있게 해 줍니다. 메시지 전송과 리액션은 명시적으로 활성화된 경우에만 사용할 수 있습니다.

할 수 있는 일

• 기억이 어렴풋한 대화를, 정확한 표현이 아니더라도 찾습니다.

• 일치하는 메시지 주변의 맥락을 복구합니다.

• 선택한 Discord 기록을 로컬 SQLite 데이터베이스에 인덱싱합니다.

• 활동량, 응답 시간, 참여도, 집중도, 호혜성, 주제를 분석합니다.

• 멤버 스냅샷을 저장하고 가입, 이탈, 역할, 기여자 성장을 분석합니다.

• 선택적으로 메시지, 답글, 리액션을 전송할 수 있습니다.

Related MCP server: Discord MCP Server

요구 사항

• Node.js 22.5 이상

• Discord 애플리케이션과 봇 토큰

• Codex처럼 로컬 stdio 서버를 지원하는 MCP 클라이언트

1. Discord 봇 만들기

1. Discord Developer Portal을 열고 애플리케이션을 생성합니다.

2. Bot 섹션을 열고 봇을 만든 뒤, 토큰을 복사합니다.

3. Bot → Privileged Gateway Intents에서 다음을 활성화합니다.

   • Message Content Intent: 메시지 내용과 검색용

   • Server Members Intent: 멤버 인증, 가입일, 역할, 성장 분석용

4. Presence Intent는 필요하지 않습니다.

5. OAuth2 → URL Generator에서 bot 범위를 선택합니다.

6. 봇에 View Channels와 Read Message History 권한을 부여합니다. 쓰기 도구를 활성화할 계획일 때만 Send Messages 또는 Add Reactions를 추가하세요.

7. 생성된 URL을 열고 봇을 Discord 서버에 초대합니다.

봇은 Discord 역할이 볼 수 있도록 허용된 채널에만 접근할 수 있습니다.

2. 설치

git clone https://github.com/blackgirlbytes/discord-community-mcp.git
cd discord-community-mcp
npm ci
npm run build
cp .env.example .env

.env를 열고 자리 표시자 토큰을 교체합니다:

DISCORD_BOT_TOKEN=replace-with-your-bot-token
DISCORD_ENABLE_WRITE=false

.env는 비공개로 유지하세요. Git에서 제외됩니다.

3. MCP 클라이언트에 추가

Codex CLI

절대 경로를 사용하여 클라이언트가 어느 디렉터리에서든 서버를 시작할 수 있게 하세요:

codex mcp add discord-community -- \
  node \
  --env-file=/absolute/path/to/discord-community-mcp/.env \
  /absolute/path/to/discord-community-mcp/dist/index.js

서버를 추가하고 나서 Codex를 다시 시작하세요.

일반적인 stdio 설정

mcpServers JSON 객체를 사용하는 클라이언트는 다음을 사용할 수 있습니다:

{
  "mcpServers": {
    "discord-community": {
      "command": "node",
      "args": [
        "--env-file=/absolute/path/to/discord-community-mcp/.env",
        "/absolute/path/to/discord-community-mcp/dist/index.js"
      ]
    }
  }
}

구성을 변경한 후 MCP 클라이언트를 다시 시작하세요. 그러면 봇이 사용할 수 있는 Discord 서버와 채널 목록을 요청할 수 있습니다.

질문 예시

• “누군가 온보딩이 숙제 같다고 말한 대화를 찾아줘.”

• “지난해봄에 SDK 이름을 바꾸는 것에 대해 우리가 무엇을 결정했지?”

• “베타 테스터의 응답이 왜 느리지? 최근 3개월간의 증거를 찾아봐.”

• “커뮤니티는 월별로 어떻게 성장했고, 성장은 참여와 어떻게 비교되나?”

• “지난주에 답변되지 않은 지원 질문은 어떤 것이었나?”

폭넓은 분석을 위해서는 에이전트가 먼저 관련 채널과 날짜 범위를 동기화하고, 인덱스 적용 범위를 확인한 다음, 커뮤니티 조사를 실행해야 합니다. 행동 패턴에 대한 설명은 메시지가 이를 직접적으로 뒷받침하지 않는 한 가설로 제시해야 합니다.

사용 가능한 도구

데이터와 개인정보 보호

메시지 내용과 멤버십 메타데이터는 기본적으로 암호화되지 않은 상태로 data/discord-analytics.sqlite에 저장됩니다. 저장 위치를 변경하려면 DISCORD_ANALYTICS_DB를 사용하세요.

DISCORD_ANALYTICS_DB=/absolute/private/path/discord-analytics.sqlite

• 분석에 필요한 채널과 날짜 범위만 인덱싱하세요.

• 커뮤니티 개인정보 보호 정책에 따라 데이터베이스를 보호하고 삭제하세요.

• 봇에 필요한 최소한의 Discord 권한만 부여하세요.

• 의도적으로 콘텐츠를 보내는 것이 아니라면 DISCORD_ENABLE_WRITE=false를 유지하세요.

• 봇 토큰이 노출되었을 경우 즉시 교체하세요.

분석의 한계

• 메시지 아카이브는 행동 패턴을 보여줄 수 있지만, 사람들이 왜 그렇게 행동했는지 증명할 수는 없습니다.

• Discord 사용자들은 Reply를 사용하지 않고 답변할 수 있으므로, 답글 지표는 실제 응답을 과소집계할 수 있습니다.

• 과거 역할 구성원 정보는 재구성되지 않으므로, 이전 그룹에는 마지막으로 관측된 역할이 사용됩니다.

• 정확한 이탈은 저장된 멤버 스냅샷 사이에서만 감지됩니다.

• 첫 번째 멤버 스냅샷으로는 봇이 관찰하기 전에 떠난 사람들을 알 수 없습니다.

• 검색과 분석은 봇이 볼 수 있는 채널이거나 동기화된 기록만 다룹니다.

• 다이렉트 메시지는 지원되지 않습니다.

쓰기 권한

쓰기 도구는 등록되어 있지만 기본적으로 차단되어 있습니다. 이들 기능을 사용하려면 .env를 변경하세요:

DISCORD_ENABLE_WRITE=true

봇에는 해당 Discord 사용 권한도 있어야 합니다. 리서치 전용 설치에서는 쓰기 기능을 비활성화한 채로 유지하세요.

개발

npm ci
npm run check
npm test

서버는 stdout이 MCP stdio 프로토콜에 예약되어 있으므로 운영 로그를 stderr에 기록합니다.