Discord Decision MCP

Claude Code가 tmux Teammate 모드로 자율 작업 중, 사용자 결정이 필요한 시점에 Discord를 통해 질문하고 응답을 받아 작업을 재개하는 MCP 서버입니다.

특징

• 프로젝트당 Bot 1개: 각 프로젝트는 독립된 Discord Bot 사용
• 무한 대기 기본값: Timeout 없이 사용자 응답 대기 (Claude가 독단 진행 금지)
• 상태 영속화: 프로세스 재시작 후에도 대기 상태 복원
• 한국어 친화적: 한글 선택지, Yes/No 응답 지원

설치

방법 1: uvx로 실행 (권장)

uv가 설치되어 있으면 별도 설치 없이 바로 실행할 수 있습니다.

# GitHub에서 직접 실행
uvx --from git+https://github.com/yarang/discord-decision-mcp discord-mcp

# 또는 PyPI 설치 후
uvx discord-decision-mcp

방법 2: 로컬 개발용 설치

# 저장소 클론
git clone https://github.com/yarang/discord-decision-mcp
cd discord-decision-mcp

# 의존성 설치 및 가상환경 생성
uv sync

# 실행
uv run discord-mcp

uv 설치

uv가 없다면:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# 또는 Homebrew
brew install uv

설정

1. Discord Bot 생성

1. Discord Developer Portal 접속
2. "New Application" 클릭하여 앱 생성
3. "Bot" 탭에서 봇 생성 및 Token 복사
4. "OAuth2 > URL Generator"에서 봇 초대 링크 생성
   • Scopes: bot
   • Permissions: Send Messages, Create Public Threads, Send Messages in Threads, Read Message History

2. 환경변수 설정

cp .env.example .env

.env 파일 수정:

DISCORD_BOT_TOKEN=Bot YOUR_BOT_TOKEN
DISCORD_CHANNEL_ID=123456789012345678
PROJECT_NAME=my-project

3. Claude Code MCP 설정

프로젝트 루트에 .mcp.json 생성:

uvx 사용 (PyPI 배포 후)

{
  "$schema": "https://github.com/anthropics/claude-code/raw/main/schema/mcp.json",
  "mcpServers": {
    "discord-decision": {
      "command": "uvx",
      "args": ["discord-decision-mcp"],
      "env": {
        "DISCORD_BOT_TOKEN": "Bot YOUR_BOT_TOKEN",
        "DISCORD_CHANNEL_ID": "123456789012345678",
        "PROJECT_NAME": "my-project"
      }
    }
  }
}

GitHub 직접 사용

{
  "$schema": "https://github.com/anthropics/claude-code/raw/main/schema/mcp.json",
  "mcpServers": {
    "discord-decision": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/yarang/discord-decision-mcp", "discord-mcp"],
      "env": {
        "DISCORD_BOT_TOKEN": "Bot YOUR_BOT_TOKEN",
        "DISCORD_CHANNEL_ID": "123456789012345678",
        "PROJECT_NAME": "my-project"
      }
    }
  }
}

로컬 개발용

{
  "$schema": "https://github.com/anthropics/claude-code/raw/main/schema/mcp.json",
  "mcpServers": {
    "discord-decision": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/discord-decision-mcp", "discord-mcp"],
      "env": {
        "DISCORD_BOT_TOKEN": "Bot YOUR_BOT_TOKEN",
        "DISCORD_CHANNEL_ID": "123456789012345678",
        "PROJECT_NAME": "my-project"
      }
    }
  }
}

참고: enableAllProjectMcpServers: true 설정이 ~/.claude/settings.json에 있으면 .mcp.json의 서버들이 자동으로 로드됩니다.

MCP Tools

discord_ask_decision (블로킹)

사용자 결정이 필요할 때 Discord Thread에 질문 전송 후 응답 대기.

result = discord_ask_decision(
    question="DB 마이그레이션을 실행할까요?",
    context="v1→v2 스키마 변경. ⚠️ 되돌리기 어려움",
    options=["A) 지금 실행", "B) 스테이징 먼저", "C) 보류"]
)
# result.answer → "A) 지금 실행"

discord_notify (논블로킹)

진행 상황 알림.

discord_notify(
    message="테스트 실행 중...",
    level="info"  # info/warning/success/error
)

discord_report_progress

작업 완료 리포트.

discord_report_progress(
    title="배포 완료",
    summary="v2.0.0 배포 성공",
    details=["✅ 테스트 통과", "✅ DB 마이그레이션 완료"]
)

discord_check_pending

세션 시작 시 미해결 질문 확인.

result = discord_check_pending()
# result.has_pending → True/False
# result.pending_questions → [...]

discord_read_inbox / discord_clear_inbox

Discord 감시 데몬이 수집한 메시지 확인 및 삭제.

result = discord_read_inbox(unread_only=True, mark_read=False)
discord_clear_inbox(read_only=True)

감시 데몬 (Discord Watcher)

Claude Code 세션과 무관하게 Discord 채널을 감시하는 별도 프로세스입니다.

# tmux 세션에서 시작
./scripts/start-discord-watch.sh

# 또는 직접 실행
uv run discord-watch --interval 10

# 상태 확인
tmux attach -t discord-watch

# 중지
tmux kill-session -t discord-watch

개발

# 테스트 실행
uv run pytest tests/ -v

# 타입 체크
uv run pyright discord_mcp/

# 포맷팅
uv run ruff format discord_mcp/

# 린트
uv run ruff check discord_mcp/

배포

PyPI 배포

# 빌드
uv build

# TestPyPI 업로드 (테스트)
uv publish --index testpypi

# PyPI 업로드
uv publish

GitHub 배포

git tag v1.0.0
git push origin v1.0.0

라이선스

MIT