discord-mcp

CLI から追加します（デフォルトではローカルプロジェクトのスコープです。すべてのプロジェクトに適用するには -s user を追加します）。

claude mcp add discord -e DISCORD_TOKEN="your-bot-token" -- npx -y @qungtai/discord-mcp

または、~/.claude.json で手動で設定します。

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@qungtai/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token"
      }
    }
  }
}

お使いのオペレーティングシステムの設定ファイルを編集します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json（非公式ビルド）

サーバーブロックを追加します。

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@qungtai/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token"
      }
    }
  }
}

CLI から追加します。

codex mcp add discord --env DISCORD_TOKEN="your-bot-token" -- npx -y @qungtai/discord-mcp

または、~/.codex/config.toml に追加します。

[mcp_servers.discord]
command = "npx"
args = ["-y", "@qungtai/discord-mcp"]

[mcp_servers.discord.env]
DISCORD_TOKEN = "your-bot-token"

.cursor/mcp.json に追加するか、Cursor Settings > MCP で設定します。

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@qungtai/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token"
      }
    }
  }
}

ボットトークン用の入力変数を指定して、.vscode/mcp.json で設定します。

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

インスペクターを起動します。

npx @modelcontextprotocol/inspector -- npx -y @qungtai/discord-mcp

接続する前に、インスペクターの環境パネルで DISCORD_TOKEN を設定します。

Docker でサーバーを起動します。

docker run -i --rm -e DISCORD_TOKEN="your-bot-token" -v /path/to/downloads:/home/node/Downloads/discord-mcp -v /path/to/uploads:/uploads ghcr.io/qungtai/discord-mcp:latest

ファイルツールを使用する場合は、ホストディレクトリを -v host_path:container_path でマウントして、コンテナーの外部からアップロードとダウンロードにアクセスできるようにします。ツールに渡すアップロードパスには、コンテナーパスを指定する必要があります。Linux のバインドマウントで、コンテナーのユーザー権限によりマウントしたホストディレクトリに書き込めない場合は、--user "$(id -u):$(id -g)" -e DISCORD_MCP_DOWNLOAD_DIR=/home/node/Downloads/discord-mcp を渡します。

MCP クライアントで設定します（Linux でカスタムの --user を使用する場合は、引数にも -e DISCORD_MCP_DOWNLOAD_DIR=/home/node/Downloads/discord-mcp を追加します）。

{
  "mcpServers": {
    "discord": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DISCORD_TOKEN",
        "-v",
        "/path/to/downloads:/home/node/Downloads/discord-mcp",
        "-v",
        "/path/to/uploads:/uploads",
        "ghcr.io/qungtai/discord-mcp:latest"
      ],
      "env": {
        "DISCORD_TOKEN": "your-bot-token"
      }
    }
  }
}

• discord_get_my_user：現在のボットユーザーを取得します
• discord_get_user：ID でユーザーを取得します
• discord_leave_guild：ギルドから退出します（承認を求めます）
• discord_list_my_connections：ボットユーザーの接続一覧を取得します
• discord_list_my_guilds：ボットがメンバーになっているギルドの一覧を取得します。after=next_after でページングします。DISCORD_MCP_ALLOWED_GUILDS が設定されている場合、ページングは利用できません。許可されているすべてのギルドが 1 回の呼び出しで返されます。
• discord_update_my_user：現在のボットのユーザー名、アバター、またはバナーを更新します（承認を求めます）

• discord_bulk_delete_messages：チャンネルから複数のメッセージ（2～100 件、14 日未満）を一度に削除します（承認を求めます）
• discord_create_pin：チャンネル内のメッセージをピン留めします
• discord_crosspost_message：アナウンスチャンネルのメッセージをクロスポスト（公開）して、フォロー中のチャンネルに配信します
• discord_delete_message：チャンネルからメッセージを削除します（承認を求めます）
• discord_delete_pin：チャンネル内のメッセージのピン留めを解除します
• discord_download_attachment：メッセージの添付ファイルを DISCORD_MCP_DOWNLOAD_DIR にダウンロードします
• discord_edit_message：メッセージの内容、埋め込み、添付ファイルのメタデータを編集するか、添付ファイルを追加します
• discord_end_poll：メッセージの投票をただちに終了します
• discord_get_message：メッセージを取得します
• discord_list_messages：メッセージを新しい順に一覧表示します。before=next_before でページングします
• discord_list_pins：チャンネル内のピン留めされたメッセージを一覧表示します
• discord_list_poll_answer_voters：特定の投票回答に投票したユーザーの一覧を取得します
• discord_search_guild_messages：ギルド内のメッセージを検索します。offset=next_offset でページングします
• discord_send_message：メッセージを送信します
• discord_trigger_typing_indicator：チャンネルに入力中インジケーターを表示します

• discord_add_my_message_reaction：現在のユーザーとしてメッセージにリアクションを追加します
• discord_delete_all_message_reactions：メッセージのリアクションをすべて削除します（承認を求めます）
• discord_delete_all_message_reactions_by_emoji：メッセージの特定の絵文字によるリアクションをすべて削除します（承認を求めます）
• discord_delete_my_message_reaction：メッセージから現在のユーザーのリアクションを削除します
• discord_delete_user_message_reaction：メッセージから別のユーザーのリアクションを削除します（承認を求めます）
• discord_list_message_reactions_by_emoji：特定の絵文字でリアクションしたユーザーの一覧を取得します

• discord_bulk_update_guild_channels: サーバー内の複数のチャンネルの位置を変更します（承認を求めます）
• discord_create_dm: ユーザーとのダイレクトメッセージチャンネルを開きます
• discord_create_guild_channel: サーバーに新しいチャンネルを作成します（承認を求めます）
• discord_delete_channel: チャンネルを削除するか、プライベートメッセージを閉じます（承認を求めます）
• discord_delete_channel_permission_overwrite: チャンネルの権限上書きを削除します（承認を求めます）
• discord_follow_channel: アナウンスチャンネルをフォローして、対象チャンネルにメッセージを送信します
• discord_get_channel: ID でチャンネルを取得します
• discord_get_member_permissions: サーバーまたはチャンネルにおけるメンバーの計算済み権限を取得します
• discord_get_role_permissions: サーバーまたはチャンネルにおけるロールの計算済み権限を取得します
• discord_list_guild_channels: サーバー内のチャンネルを一覧表示します
• discord_set_channel_permission_overwrite: チャンネルの権限上書きを設定または更新します（承認を求めます）
• discord_update_channel: チャンネルの設定を更新します（承認を求めます）
• discord_update_voice_channel_status: ボイスチャンネルのステータスを設定またはクリアします（承認を求めます）

• discord_create_webhook: チャンネルに新しいウェブフックを作成します
• discord_delete_webhook: ウェブフックを完全に削除します（承認を求めます）
• discord_delete_webhook_message: ウェブフックが以前に送信したメッセージを削除します（承認を求めます）
• discord_edit_webhook_message: ウェブフックが以前に送信したメッセージを編集します（承認を求めます）
• discord_execute_webhook: ウェブフックを実行してメッセージを送信します（承認を求めます）
• discord_get_webhook: ID でウェブフックを取得します
• discord_get_webhook_message: ウェブフックが以前に送信したメッセージを取得します
• discord_list_channel_webhooks: チャンネル内のウェブフックを一覧表示します
• discord_list_guild_webhooks: サーバー内のウェブフックを一覧表示します
• discord_update_webhook: ウェブフックの名前やアバターを更新するか、別のチャンネルに移動します（承認を求めます）

• discord_add_guild_member_role: ギルドメンバーにロールを追加します（承認を求めます）
• discord_delete_guild_member: ギルドからメンバーを削除（キック）します（承認を求めます）
• discord_delete_guild_member_role: ギルドメンバーからロールを削除します（承認を求めます）
• discord_get_guild_member: ユーザーIDでギルドメンバーを取得します
• discord_list_guild_join_requests: ギルドへの参加リクエストを一覧表示します。申請ステータスで絞り込むこともできます
• discord_list_guild_members: ギルドメンバーを一覧表示します。特権GatewayインテントのServer Members（GUILD_MEMBERS）が必要です。after=next_afterでページ分割します
• discord_preview_prune_guild: プルーニング操作で削除されるメンバー数を取得します
• discord_prune_guild: ギルドから非アクティブなメンバーを削除するプルーニング操作を開始します（承認を求めます）
• discord_review_guild_join_request: ギルドへの参加リクエストを承認または拒否します。rejection_reasonは、actionがREJECTEDの場合にのみ使用されます（承認を求めます）
• discord_search_guild_members: ユーザー名またはニックネームが検索語で始まるギルドメンバーを検索します。特権GatewayインテントのServer Members（GUILD_MEMBERS）が必要です
• discord_update_guild_member: ギルドメンバーの属性を更新します。Discordではここでボット自身を編集できません。ボット自身のニックネームを変更するにはdiscord_update_my_guild_memberを使用します。channel_idを指定するとメンバーをボイスチャンネルに移動し、nullを指定すると切断します（承認を求めます）
• discord_update_my_guild_member: 現在のボットのニックネームまたはギルド内のメンバープロフィールを更新します

• discord_bulk_update_guild_roles: ギルド内のロールオブジェクトのリストの位置を変更します（承認を求めます）
• discord_create_guild_role: ギルドに新しいロールを作成します（承認を求めます）
• discord_delete_guild_role: ギルドのロールを削除します（承認を求めます）
• discord_get_guild_role: ギルドのロールを取得します
• discord_get_guild_role_member_counts: ギルドのロールごとのメンバー数を取得します
• discord_list_guild_roles: ギルドのロールを一覧表示します
• discord_update_guild_role: ギルドのロールを更新します（承認を求めます）

• discord_count_guild_scheduled_event_users：ギルドのスケジュール済みイベントとその例外のユーザー数を取得します
• discord_create_guild_scheduled_event：ギルドのスケジュール済みイベントを作成します
• discord_create_guild_scheduled_event_exception：繰り返し行われるギルドのスケジュール済みイベントの例外を作成します
• discord_delete_guild_scheduled_event：ギルドのスケジュール済みイベントを削除します（承認を求めます）
• discord_delete_guild_scheduled_event_exception：繰り返し行われるギルドのスケジュール済みイベントの例外を削除します（承認を求めます）
• discord_get_guild_scheduled_event：ID でギルドのスケジュール済みイベントを取得します
• discord_list_guild_scheduled_event_exception_users：ギルドのスケジュール済みイベントの特定の繰り返し例外を購読しているユーザーを、ユーザー ID の昇順で一覧表示します。after=next_after でページ分けします
• discord_list_guild_scheduled_event_users：ギルドのスケジュール済みイベントを購読しているユーザーを、ユーザー ID の昇順で一覧表示します。after=next_after でページ分けします
• discord_list_guild_scheduled_events：ギルドのスケジュール済みイベントを一覧表示します
• discord_update_guild_scheduled_event：ギルドのスケジュール済みイベントを変更します（承認を求めます）
• discord_update_guild_scheduled_event_exception：繰り返し行われるギルドのスケジュール済みイベントの例外を変更します（承認を求めます）

• discord_add_invite_target_user：既存の招待に対象ユーザーを追加します（承認を求めます）
• discord_bulk_add_invite_target_users：既存の招待に複数の対象ユーザーを追加します（承認を求めます）
• discord_bulk_delete_invite_target_users：既存の招待から複数の対象ユーザーを削除します（承認を求めます）
• discord_create_channel_invite：チャンネルの新しい招待を作成します（承認を求めます）
• discord_delete_invite：コードで招待を削除します（承認を求めます）
• discord_delete_invite_target_user：既存の招待から対象ユーザーを削除します（承認を求めます）
• discord_get_invite：コードで招待を取得します。許可リストの設定下では、メッセージを確認できるように、target_message_id を設定する場合は target_channel_id も必要です。
• discord_get_invite_target_users_job_status：招待の対象ユーザー処理のステータスを取得します
• discord_list_channel_invites：チャンネルの有効な招待をすべて取得します
• discord_list_guild_invites：ギルドの有効な招待をすべて取得します
• discord_list_invite_target_users：招待の対象ユーザーを取得します。レスポンスは csv フィールドの CSV テキストとして返されます。
• discord_set_invite_target_users：CSV ファイルを使用して招待の対象ユーザーを設定します。（承認を求めます）