Dc-MCP

Discord Administration MCP Server for Cursor.

Dc-MCPは、Model Context Protocol (stdio)を介してCursorをDiscordボットに接続します。Cursorは、ギルドの完全な構造を検査し、明示的なツールを通じて正確な管理操作を実行できます。自由形式のDiscord APIエグゼキューターではありません。

Cursor  ──MCP (stdio)──▶  Dc-MCP  ──discord.py──▶  Discord API

機能

• Cursor向けの完全なギルドマップ（discord_analyze_server / discord_server_structure）

• チャンネル、ロール、メンバー、メッセージ、モデレーション、招待、ウェブフック、監査ログ用の詳細なツール

• 中央集権的な権限+階層チェック（オーナーを対象にしない、ボットより上のロールを対象にしない）

• 破壊的操作の保護（confirm=true + オプションのハード無効化）

• 構造化されたJSON結果。シークレットは返却・記録されません

• CursorのMCPクライアントと互換性のあるStdioトランスポート

Related MCP server: Discord MCP Server

要件

• Python 3.11+

• Discordアプリケーション+ボット

• 特権インテント: Server Members Intent、Message Content Intent

クイックスタート

git clone https://github.com/669px/Dc-MCP.git
cd Dc-MCP
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .
cp .env.example .env

.envを編集:

DISCORD_BOT_TOKEN=your_bot_token
DISCORD_GUILD_ID=your_guild_id
ALLOW_DANGEROUS_ACTIONS=true
REQUIRE_CONFIRMATION=true
LOG_LEVEL=INFO

実行:

python -m src.main

ログはstderrに出力されます。stdoutはMCP JSON-RPC用に予約されています。

Discordボットのセットアップ

1. Discord Developer Portalでアプリケーションを作成

2. ボットを追加し、トークンをDISCORD_BOT_TOKENにコピー

3. Server Members IntentとMessage Content Intentを有効化

4. チャンネル/ロール/メッセージの管理、キック/バン、メンバーのモデレーション、監査ログの表示、ウェブフック/ギルドの管理、メッセージの送信、埋め込みリンク、リアクションの追加、メッセージ履歴の読み取り、インスタント招待の作成などの権限でボットを招待

5. 管理対象のロール/メンバーを管理できるよう、ボットのロールを十分高い位置に配置

6. DISCORD_GUILD_IDを設定して、すべての操作を1つのギルドに制限

Cursor MCP設定

プロジェクトまたはユーザーのmcp.json:

{
  "mcpServers": {
    "discord-admin": {
      "command": "/ABSOLUTE/PATH/TO/Dc-MCP/.venv/bin/python",
      "args": ["-m", "src.main"],
      "cwd": "/ABSOLUTE/PATH/TO/Dc-MCP"
    }
  }
}

シークレットはcwdの.envから読み込まれます。保存後、Settings → Tools & MCPでdiscord-adminを有効化/更新してください。

CLI:

agent mcp enable discord-admin
agent mcp list

コアツール

その他にも含まれるもの: チャンネルのCRUD+権限、ロールのCRUD+割り当て/削除、メンバーのモデレーション（キック/バン/タイムアウト/ニックネーム）、メッセージング（送信/編集/削除/ピン留め/リアクション）、招待、ウェブフック、discord_purge_messages。

破壊的ツールは、REQUIRE_CONFIRMATION=trueの場合にconfirm=trueが必要です。

セキュリティ

• .envをコミットしない

• REQUIRE_CONFIRMATION=trueを推奨

• DISCORD_GUILD_IDでスコープを制限

• メンションはデフォルトで制限（許可されない限り@everyone/大量ロールはオフ）

• シェル、eval、HTTPプロキシ、汎用APIエグゼキューターのツールはなし

• ウェブフックトークンは決して返却されない

プロジェクト構成

src/
  main.py              MCP entrypoint (stdio)
  config.py            Environment settings
  discord_client.py    discord.py client
  permissions.py       Guild / hierarchy / confirmation gates
  errors.py            Structured error mapping
  responses.py         Success / failure payloads
  server_map.py        Full guild analysis for Cursor
  tools/               Granular MCP tools
tests/                 Unit tests (mocked Discord)

開発

source .venv/bin/activate
python -m compileall src
python -m pytest
python -c "import discord; print(discord.__version__)"

Discordの制限事項

• 一括削除は14日未満のメッセージでのみ機能

• 一括/パージの上限はデフォルトで100

• ギルドオーナーやボットの最上位ロール以上の対象はモデレーション不可

• 管理/統合ロールは編集不可

• メンバーリスト/検索にはServer Members Intentが必要

ライセンス

MIT