Discord MCP Server

Discord MCP Server とは？

Discord MCP は SaseQ によるオープンソースの Model Context Protocol サーバーです。Discord ボットを Claude、Cursor、Codex などの AI アシスタントに接続し、Discord API を通じてメッセージの送受信、チャンネル・ロール・メンバーの管理、モデレーションを行えるようにします。

Discord 公式の製品ではなく、コミュニティプロジェクトです。Java と JDA（Java Discord API）で書かれており、通常は Docker 上で常駐型の HTTP サーバーとして http://localhost:8085/mcp で動作します。クライアントセッションごとにコンテナを起動する従来の stdio モードにも対応しています。

Discord MCP Server の使い方

前提条件： Discord ボットのトークンと Docker（または JAR を自分でビルドするための Java と Maven）。README からリンクされている discord.js のアプリ設定ガイド に従ってボットを作成し、トークンをコピーしてから、ボットを自分のサーバーに招待します。

1. 環境変数を設定します。

export DISCORD_TOKEN="YOUR_DISCORD_BOT_TOKEN"
export DISCORD_GUILD_ID="OPTIONAL_DEFAULT_SERVER_ID"
export SPRING_PROFILES_ACTIVE=http

DISCORD_GUILD_ID は任意です。設定すると、guildId を受け取るツールでその指定を省略できます。

2. Docker コンテナを起動します。

docker run -d -i \
  --name discord-mcp \
  --restart unless-stopped \
  -p 8085:8085 \
  -e SPRING_PROFILES_ACTIVE \
  -e DISCORD_TOKEN \
  -e DISCORD_GUILD_ID \
  saseq/discord-mcp:latest

MCP エンドポイントは http://localhost:8085/mcp です。Docker Compose や mvn clean package による手動ビルドの手順も README にあります。

Claude Code

claude mcp add discord-mcp --transport http http://localhost:8085/mcp

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "discord-mcp": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

Claude Desktop

claude_desktop_config.json で stdio の設定を使います。

{
  "mcpServers": {
    "discord-mcp": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

Claude Desktop のリモートコネクタ（Settings > Connectors）には公開 HTTPS の URL が必要なため、トンネルやリバースプロキシなしでは localhost は使えません。

Codex

codex mcp add discord-mcp --url http://localhost:8085/mcp

README には OpenClaw と n8n の MCP Client ノードの手順もあります。

Discord MCP Server の主な機能

• JDA を使い、Discord 公式 API を通じてボットとしてアクセス
• すべてのクライアントで共有する 1 つの HTTP サーバー、または従来のセッションごとの stdio モード
• チャンネルと DM のメッセージ。履歴は 1〜100 件まで、before/after/around カーソルで取得可能
• サーバー管理：チャンネル、カテゴリー、ロール、権限の上書き、招待、絵文字、イベント
• モデレーション：キック、BAN、BAN 解除、タイムアウト、ニックネーム変更
• フォーラム、ボイス、ステージチャンネルの管理
• DISCORD_GUILD_ID による既定サーバーの指定。ヘルスチェック用エンドポイント /actuator/health
• MIT ライセンス。saseq/discord-mcp Docker イメージとして公開

Discord MCP Server のツール

サーバーは多数のツールを領域ごとに提供しています。

• メッセージ： send_message、read_messages、edit_message、delete_message、add_reaction、remove_reaction。DM は send_private_message と read_private_messages。
• チャンネルとカテゴリー： list_channels、find_channel、create_text_channel、edit_text_channel、move_channel、delete_channel、create_category。
• ロールと権限： list_roles、create_role、assign_role、remove_role、upsert_role_channel_permissions。
• モデレーション： kick_member、ban_member、unban_member、timeout_member、get_bans。
• コミュニティ機能： webhook（send_webhook_message）、招待（create_invite）、フォーラム（create_forum_post）、イベント（create_guild_scheduled_event）、絵文字、ボイスチャンネル。
• 検索： get_server_info と get_user_id_by_name（<@id> 形式のメンションに便利）。

Discord MCP Server のユースケース

• お知らせ：「Post the release notes for v2.3 in #announcements.」
• 状況の把握：「Read the last 100 messages in #support and list unanswered questions.」
• コミュニティの構築：「Create an Events category with text and voice channels and a Moderator role that can manage them.」
• モデレーション：「Time out the user spamming in #general for 10 minutes and delete their last three messages.」
• イベント：「Schedule a stage event for Friday at 6 pm and list who is interested.」
• 自動化：n8n の MCP Client ノードを使って、このサーバーを n8n ワークフローに接続する。

Discord MCP Server と代替ツールの比較

ほかの Discord MCP サーバーは異なるアプローチを取っています。1 つの webhook URL からの投稿しかできないものや、ボットではなくユーザーアカウントでログインするものがあり、後者は Discord の規約に抵触する可能性があります。このサーバーはボットトークンと公式 API を使うため、権限が明確で、カバーする API の範囲もずっと広くなっています。チームが Discord ではなく Slack を使っているなら、Slack MCP Server を参照してください。

Discord MCP Server のトラブルシューティング

• クライアントが接続できない： docker ps --filter name=discord-mcp でコンテナが動いているか確認し、curl -fsS http://localhost:8085/actuator/health をチェックします。
• Docker 上の n8n からサーバーに届かない： localhost は n8n コンテナ自身を指します。http://discord-mcp:8085/mcp のように Docker のサービス名を使ってください。
• Claude Desktop のリモートコネクタが失敗する： http://localhost:8085/mcp は自分のマシンからしかアクセスできません。stdio の設定を使うか、公開 HTTPS でエンドポイントを公開してください。
• 毎回 guildId を求められる： DISCORD_GUILD_ID を設定して既定値にします。
• 古いガイドの設定で JAR を直接起動している： 現在の README では SPRING_PROFILES_ACTIVE=http で JAR を常駐サーバーとして動かし、クライアントは http://localhost:8085/mcp に接続します。推奨のインストール方法は Docker です。