discord-mcp

AIエージェントにDiscord REST APIの全機能を公開する、プロダクショングレードのModel Context Protocolサーバー。

ステータス: v0.9.0 · 192個のツール · OTel計測済み · Cockatielによる耐障害性 · 監査ログ記録済み

アーキテクチャについては設計仕様書を参照してください。

クイックスタート

# 1. Install
npm install -g @discord-mcp/cli  # or use npx

# 2. Bootstrap config for your MCP client
discord-mcp init --client claude-desktop --token "Bot YOUR.BOT.TOKEN"

# 3. Verify configuration
discord-mcp doctor --online

# 4. Run (or let your MCP client launch it)
discord-mcp serve

サブコマンド

discord-mcp serve (デフォルト)

stdio MCPサーバーを起動します。サブコマンドが指定されていない場合のデフォルトの動作です。

フラグ:

• --gateway — Discord Gatewayリソースのサブスクリプションを有効にする (discord.jsを遅延インポート)

discord-mcp doctor

設定と接続性を診断します。終了コードは0（正常）、1（警告）、2（エラー）です。

フラグ:

• --online — ネットワークチェックを実行する (Discordトークンの検証、OTelの到達可能性)

• --json — CI用にJSON形式で出力する

オフラインチェック: node-version, token-format, env-vars, audit-sink, client-caps オンラインチェック (--online使用時): token-online, otel-reachable

discord-mcp init

設定のブートストラップとMCPクライアント設定スニペットの生成を行います。

フラグ:

• --token <token> — Discordボットトークン (または ${env:DISCORD_TOKEN} プレースホルダー)

• --client <id> — クライアント: claude-desktop, claude-code, cursor, または generic

• --output <path> — スニペットをファイルに書き出す (デフォルト: stdout)

• --force — 既存の出力ファイルを上書きする

• --gateway — 生成される設定でDiscord Gatewayを有効にする

• --json — CI用のJSON出力

stdinがTTYでフラグが指定されていない場合、initは対話型ウィザードを実行します。

discord-mcp migrate

他のDiscord/MCPセットアップからの移行を行います。終了コードは0（すべてマッピング済み）、1（一部未マッピング）、2（エラー）です。

フラグ:

• --from <adapter> — ソースアダプターID (--fromなしで実行すると一覧表示)

• --source <path> — ソースリポジトリへのパス (デフォルト: cwd)

• --json — JSON出力

利用可能なアダプター: hubdustry-go-mcp (リファレンス実装)。詳細はプラン11を参照。

ツールサーフェス

以下のカテゴリにわたる192個のツール:

• messages (12)

• channels (14)

• threads (6)

• members (14)

• roles (5)

• guild (16)

• audit_log (1)

• webhooks (13)

• events (6)

• commands (15)

• users (6)

• components-v2 (8)

• intelligence (5)

• meta (1)

• reactions (5)

• emojis (5)

• app_emojis (5)

• stickers (7)

• invites (4)

• automod (5)

• interactions (8)

• application (5)

• stage_instances (4)

• soundboard (7)

• polls (2)

• voice (3)

• onboarding (2)

• monetization (8)

ローカル開発

前提条件: Node ≥20.11, pnpm ≥9.15.

pnpm install
pnpm build
pnpm test

スモークテスト (実際のDiscord)

DISCORD_TOKEN に https://discord.com/developers/applications から取得した実際のボットトークンを設定します:

export DISCORD_TOKEN="Bot YOUR_TOKEN_HERE"
node packages/mcp-server/dist/cli.js

次に、別のターミナルで MCP Inspector を使用します:

npx -y @modelcontextprotocol/inspector node packages/mcp-server/dist/cli.js

http://localhost:5173 でInspector UIを開き、tools/list をクリックすると、192個すべてのツールが表示されるはずです。

ドキュメント

• 運用: テレメトリ — OTelの設定

• 運用: 耐障害性 — リトライ/タイムアウト/サーキットブレーカーの調整

• 運用: 監査 — 監査シンクとコンプライアンス

ライセンス

MIT — LICENSE を参照してください。