@devli13/mcp-discord

Discord用のMCPサーバーです。Claude Code、Paperclipエージェント、Gemini CLI、またはその他のMCP互換クライアントから、メッセージの送信、モデレーション、チャンネル管理、サーバーの調査を行うことができます。

純粋なRESTラッパーです。Gatewayは使用せず、データベースもありません。 Discordのv10 APIを26個の十分にドキュメント化されたツールとして提供し、ルートごとのレート制限と構造化されたエラー結果をサポートしています。

なぜこれが必要か

DiscordのAPIは広大で、生の curl で呼び出すにはエージェントにとって不親切です。エージェントはレート制限に抵触したり、429エラーを適切に処理できなかったり、監査ログの理由付けに失敗したり、ページネーションのカーソルを忘れたりします。このMCPはそれらを一度に解決するため、エージェントは「そのスパムメッセージを削除する」「#mod-logに日次ダイジェストを投稿する」「@userを1時間タイムアウトにする」といった意図に集中できます。

人間にとっても便利です。Claude Codeに接続すれば、「Discordの#devチャンネルの過去50件のメッセージを要約して」と言うだけで、Claudeがそれを実行してくれます。

Related MCP server: Discord Bridge MCP Server

インストール

npm install -g @devli13/mcp-discord

またはnpx経由（インストール不要）:

DISCORD_BOT_TOKEN=<your-token> npx -y @devli13/mcp-discord

セットアップ

1. Discordボットの作成

1. https://discord.com/developers/applications にアクセスし、New Application をクリックします。

2. アプリケーションに Bot を追加します。

3. ボットトークンをコピーします。これが DISCORD_BOT_TOKEN になります。

4. OAuth2 URLジェネレーター（スコープ: bot）を使用して、ボットをサーバーに招待します。MCPに実行させたい操作（例：削除のための「メッセージの管理」、タイムアウトのための「メンバーのモデレーション」）に基づいて権限を選択してください。

2. MCPクライアントへの接続

Claude Code:

claude mcp add discord \
  --env DISCORD_BOT_TOKEN=<your-token> \
  -- npx -y @devli13/mcp-discord

Paperclip mcp-gateway (.mcp.json):

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@devli13/mcp-discord"],
      "env": {
        "DISCORD_BOT_TOKEN": "<your-token>"
      }
    }
  }
}

Gemini CLI (~/.gemini/config.json):

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@devli13/mcp-discord"]
    }
  }
}

3. （オプション）特権インテントの有効化

サーバーメンバーの一覧表示 (discord_list_members) を行いたい場合や、インバウンドイベント用のコンパニオンプラグインと併用する場合は、ボットのDeveloper Portal設定で Server Members Intent と Message Content Intent を有効にしてください。これらはほとんどのMCP操作には不要で、特定のエンドポイントでのみ必要となります。

ツールリファレンス

すべてのツールには discord_* というプレフィックスが付いており、JSONブロブ（成功時）またはフォーマットされたエラーメッセージ（失敗時）を返します。例外はスローされず、すべてのツールが使用可能な文字列結果を返します。

メッセージ (8)

リアクション (3)

チャンネルとスレッド (5)

モデレーション (6)

サーバー情報 (4)

含まれていない機能（意図的）:

• ban/unban — 意図的な制限です。DiscordのUIを使用してください。不可逆的なアクションはエージェントの呼び出し1回で実行されるべきではありません。

• チャンネルの作成/削除/編集 — 影響範囲が大きいため、UIを使用してください。

• Webhook CRUD — ほとんどのエージェントフローでは不要です。将来のリリースで追加する可能性があります。

• 音声操作、スタンプ/絵文字管理 — v0.1のスコープ外です。

例: Claude Codeによるチャンネルの要約

User: Summarize the last 30 messages in the #dev channel of my Discord server, guild ID 1234...

Claude (calls discord_list_channels → finds #dev → calls discord_list_messages → writes summary)

例: Paperclipエージェントによる日次ダイジェスト

// From an agent's prompt:
"Post the daily digest to channel 1234. Summarize the last 24h of activity
using discord_list_messages with limit=100, then format as an embed via
discord_send_message."

エラーハンドリング

すべてのツールは使用可能なテキスト結果を返します。エラー発生時:

Error (DISCORD_50001, HTTP 403): Missing Access
Details: [...]
(This error is transient and may succeed on retry.)

MCPは、429（レート制限）および5xx（サーバーエラー）に対する再試行を、指数バックオフを用いて内部的に処理します。

レート制限

Discordには2つのレート制限レイヤーがあります:

1. ルートごと — 各APIエンドポイントは独立したバケットを持っています。このMCPは、429エラーを回避するために（メソッド + ルートテンプレート）ごとにリクエストをシリアル化します。

2. グローバル — ボットごと、全エンドポイント共通。MCPはグローバルに Retry-After ヘッダーを尊重します。

これについて意識する必要はありません。もしグローバル制限に繰り返し抵触する場合は、人間が介入すべき操作を行っている可能性が高いです。

セキュリティ

• ボットトークンをコミットしないでください。 このMCPは起動時に DISCORD_BOT_TOKEN 環境変数から読み取ります。

• 最小権限の招待URLを使用してください。 「メッセージの管理」だけで十分な場合に、ボットに「管理者」権限を与えないでください。

• 監査ログの理由 — すべてのモデレーションツールは、Discordの監査ログに表示される reason 引数を受け付けます。活用してください。

開発

git clone https://github.com/devli13/mcp-discord.git
cd mcp-discord
npm install
npm test           # smoke tests (no live Discord calls)
npm run lint       # syntax check all files
npm start          # boot server over stdio (needs DISCORD_BOT_TOKEN)

コンパニオンプロジェクト — インバウンドイベント

このMCPはアウトバウンドのREST呼び出し（送信、削除、モデレーション）を処理します。Discord Gateway WebSocketを保持しないため、インバウンドイベント（ボットへの@メンション、DM、新規メンバーの参加など）には反応できません。

Paperclip環境でDiscordのインバウンドイベントを処理するには、@devli13/paperclip-plugin-discord を使用してください。これは @mvanhorn/paperclip-plugin-discord のフォークであり、自由形式の@メンションルーティング、DMサポート、コンテキストごとのシリアル化されたメッセージキュー、ダウンタイム時のメンションバックフィル機能を備えています。

これら2つのプロジェクトは連携するように設計されています。プラグインがイベントを受信してエージェントを呼び出し、エージェントがこのMCPを使用して応答やモデレーションを行います。セットアップに応じて、どちらか一方または両方を使用してください。

帰属表示

ATTRIBUTION.md を参照してください。要約: @mvanhorn による paperclip-plugin-discord のフォークと並行して構築されました。そのGateway処理がここでの設計パターンのインスピレーションとなっています。

ライセンス

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