discord-mcp

このサーバーを選ぶ理由

• 95 以上のツール：メッセージ、チャンネル、ロール、権限、モデレーション、フォーラム、Webhook、スケジュール済みイベント、招待、DM、埋め込みなど
• マルチギルド対応：複数のサーバーで動作し、GUILD_ID に固定されません
• 軽量：TypeScript + Node.js、パッケージは約 70kB、Docker イメージは約 73MB（Java ベースの代替製品は 400MB 以上）
• モジュール式：すっきりしたアーキテクチャで、新しいツールを簡単に追加できます
• 2 種類のインストール方法：npm または Docker から選択できます

クイックスタート

これを MCP クライアントの設定に追加し、YOUR_TOKEN_HERE をボットのトークンに置き換えてください。

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@pasympa/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

インストールは不要です。npx がすべて処理します。

まだボットを作成していませんか？Discord ボットの作成をご覧ください。

設定

claude mcp add discord -e DISCORD_TOKEN=YOUR_TOKEN_HERE -- npx -y @pasympa/discord-mcp

{
  "inputs": [
    {
      "type": "promptString",
      "id": "discord-token",
      "description": "Discord Bot Token",
      "password": true
    }
  ],
  "servers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@pasympa/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "${input:discord-token}"
      }
    }
  }
}

{
  "mcpServers": {
    "discord": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DISCORD_TOKEN=YOUR_TOKEN_HERE",
        "pasympa/discord-mcp:latest"
      ]
    }
  }
}

git clone https://github.com/PaSympa/discord-mcp
cd discord-mcp
npm install && npm run build

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

DISCORD_TOKEN=YOUR_TOKEN_HERE

2.1.1 以降、サーバーは GuildMessages インテントを一切要求しなくなりました。ここではメッセージイベントを購読しておらず、このサーバーが返すすべてのメッセージは REST 経由で取得されるため、接続インテントによる制御は受けません。このインテントは、discord.js があらゆるチャンネルを流れるすべてのメッセージをその投稿者とともにキャッシュする原因となっており、長時間稼働するサーバーでは無制限に増大していました。現在はキャッシュスイーパーが残存分を制限しています。したがって DISCORD_MESSAGE_CONTENT は、接続時に Message Content インテントを要求するかどうかにのみ影響し、いずれかのツールが返す内容を変えるものではありません。

これらのフラグは、サーバーが識別時に要求するゲートウェイインテントを制御するだけです。Developer Portal で有効化されていない特権インテントを要求すると、最初のツール呼び出しで接続が失敗します (クローズコード 4014)。そのまま接続するにはフラグを false に設定してください。

データアクセスはこれらのフラグではなく、ポータルのトグルによって制御されます。このサーバーは REST API 経由ですべてを読み取っており、Discord はポータル設定のみでこれを制御します。したがって、ポータルのトグルがオンの状態でこれらのフラグを false に設定しても、失われるものはありません。ポータルのトグルがオフの場合、対応するデータはフラグに関係なく制限されます。メッセージ本文は空で返り (content、embeds、attachments。ただしボット自身のメッセージ、DM、およびボットに言及したメッセージを除く)、メンバー一覧の取得も失敗します。ポータルでトグルを有効にすると復元されます。

ツールセット (DISCORD_MCP_TOOLSETS): discovery、messages、channels、permissions、members、roles、moderation、screening、stats、forums、webhooks、scheduled_events、invites、dm。例: DISCORD_MCP_TOOLSETS=discovery,messages,members は discovery、message、member のツールのみを公開します。注意: ツールセットはそのモジュール全体を同梱し、破壊的なツールも含まれます (messages には一括削除が含まれ、members には kick/ban が含まれます)。これらを制限するには DISCORD_ALLOWED_GUILDS とドライランのデフォルト値を使用してください。公開および呼び出し可能なのは、リストされたツールセットのツールのみです。不明な名前を指定すると、すべてを暗黙的に公開するのではなく、サーバーは起動時に失敗します (空の値は未設定として扱われ、すべてを公開します)。

Discord ボットの作成

1. discord.com/developers/applications にアクセスします

2. New Application > 名前を入力します

3. Bot タブ > Reset Token > トークンをコピーします

4. Privileged Gateway Intents を有効にします（このサーバーはデフォルトで両方を要求しますが、新しい Discord アプリではポータルのトグルが OFF になっています）：

   • Server Members Intent
   • Message Content Intent

   重要： ボットがここで有効になっていない特権インテントを要求すると、Discord はコード 4014 で接続を閉じ、すべてのツール呼び出しが失敗します。両方を有効にするか、不要なものの要求を上記の環境変数で停止してください。

5. OAuth2 > URL Generator：

   • Scopes: bot
   • Permissions: Send Messages、Read Message History、Manage Channels、Manage Roles、Kick Members、Ban Members、Moderate Members、View Audit Log、Manage Messages、Manage Threads、Add Reactions、Manage Guild、Manage Webhooks、Manage Events、Create Events、Create Instant Invite、Manage Nicknames、Pin Messages、Embed Links、Create Public Threads、Send Messages in Threads

6. 生成された URL をコピーして、ボットをサーバーに招待します

利用可能なツール (99)

検出とナビゲーション (4 ツール)

メッセージ（20 ツール）

チャンネル（8 ツール）

チャンネル権限（6 ツール）

メンバー (11 ツール)

ロール (9 ツール)

フォーラム (10 ツール)

Webhook (8 ツール)

スケジュール済みイベント (7 ツール)

ダイレクトメッセージ (7 ツール)

招待 (5 ツール)

モデレーションとスクリーニング (3 ツール)

統計 (1 ツール)

使用例

"List all servers the bot is in"
"Read the last 10 messages in #general"
"Send 'Hello everyone!' to the announcements channel"
"Create a forum channel called 'feedback' with tags Bug, Feature, Question"
"Show the full permission audit for the server"
"Create a webhook on #notifications and send a test message"
"Ban user 112233445566778899 and delete their messages from the last 3 days"
"Create an event called 'Game Night' for next Friday at 8pm"
"List all upcoming events in the server"
"Create a permanent invite for #general"
"List all active invites and delete expired ones"
"Send a DM to user 112233445566778899 saying 'Your build passed!'"
"Search for members named 'john'"
"List all banned users in the server"
"Show all pinned messages in #general"
"Forward that message to #announcements"

Discord ID の確認方法

Discord で 開発者モード を有効にします: Settings > Advanced > Developer Mode

次に、サーバー、チャンネル、またはユーザーを 右クリック > ID をコピー します。

プロジェクト構造

discord-mcp/
├── src/
│   ├── index.ts             ← Entry point (MCP server + transport)
│   ├── client.ts            ← Discord client + shared helpers
│   ├── constants.ts         ← Shared constants (limits, defaults)
│   ├── embeds.ts            ← Shared embed schema + builder
│   └── tools/
│       ├── index.ts         ← Tool registry (toolset gating, dispatch)
│       ├── define.ts        ← defineTool/defineModule + shared zod fields
│       ├── types.ts         ← Shared TypeScript interfaces
│       ├── discovery.ts     ← Guild/channel discovery
│       ├── messages.ts      ← Message CRUD, reactions, threads, embeds
│       ├── channels.ts      ← Channel management
│       ├── permissions.ts   ← Permission overwrites
│       ├── members.ts       ← Member management
│       ├── roles.ts         ← Role CRUD and assignment
│       ├── moderation.ts    ← Audit log
│       ├── screening.ts     ← Membership screening
│       ├── stats.ts         ← Server statistics
│       ├── forums.ts        ← Forum channels, posts, tags
│       ├── webhooks.ts      ← Webhook management
│       ├── scheduledEvents.ts ← Scheduled events
│       ├── invites.ts        ← Invite management
│       └── dm.ts             ← Direct messages
├── test/                     ← node:test suite (schemas, gating, allow-list)
├── scripts/                  ← sync-version.js (npm version hook)
├── .github/workflows/        ← CI/CD (build check + auto release)
├── Dockerfile
├── .dockerignore
├── .env.example
├── package.json
├── tsconfig.json
├── CHANGELOG.md
├── CONTRIBUTING.md
├── SECURITY.md
└── README.md

新しいツールの追加

1. src/tools/ に新しいファイルを作成します（例: events.ts）
2. 各ツールを defineTool({ name, description, annotations, schema, handle }) で宣言し、defineModule([...]) をデフォルトとしてエクスポートします
3. それをインポートし、src/tools/index.ts 内の allToolsets に追加します（キーはその DISCORD_MCP_TOOLSETS 名です）

セキュリティ

• Discord トークンを絶対に Git にコミットしないでください
• 環境変数または .env ファイル（バージョン管理対象外）を使用してください
• ボットには必要な権限のみを付与してください
• DISCORD_ALLOWED_GUILDS でサーバーを特定のサーバーに制限してください
• 取り消し不可能な一括操作（bulk_ban、prune_members、bulk_delete_messages、delete_channel）はデフォルトで dry_run プレビューになります。適用するには dry_run:false を渡してください

コントリビューション

コントリビューションを歓迎します！

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/my-feature）
3. モジュール構造に従ってください。新しいツールの追加を参照してください
4. 変更をコミットし、プルリクエストを作成します

ライセンス

MIT、詳細は LICENSE を参照してください。