Discord Admin MCP Server

Discordサーバー管理、ロール管理、メンバー管理、チャンネル操作のための構造化ツールを提供するModel Context Protocol (MCP)サーバーです。

Hermes AgentおよびMCP準拠のクライアントとシームレスに連携するように設計されています。

機能とツール

• サーバー情報:

  • get_current_bot_user: ボットのIDとユーザー詳細を確認します。

  • list_guilds: ボットが所属するサーバーを一覧表示します。

  • get_guild_info: メンバー数、オーナーID、サーバー設定を取得します。

• ロール管理:

  • list_roles: サーバーロール、ポジション、権限ビットフィールドを一覧表示します。

  • assign_role: メンバーにロールを割り当てます。

  • remove_role: メンバーからロールを削除します。

  • create_role: カスタムカラーと権限を持つ新しいロールを作成します。

  • delete_role: サーバーからロールを削除します。

• メンバー管理:

  • kick_member: 監査ログに理由を記録してメンバーをキックします。

  • ban_member: メッセージ削除期間を指定してメンバーをBANします。

  • unban_member: メンバーのBANを解除します。

  • timeout_member: メンバーを指定期間タイムアウト（ミュート/隔離）します。

• チャンネル管理:

  • list_channels: テキスト、ボイス、フォーラム、アナウンスチャンネルを一覧表示します。

  • create_channel: カスタムカテゴリ/トピックでチャンネルを作成します。

  • edit_channel: チャンネル名、NSFW設定、トピックを編集します。

  • delete_channel: チャンネルを削除します。

• メッセージ管理:

  • purge_messages: 最近のメッセージを一括削除します。

Related MCP server: Discord MCP Server

インストールとセットアップ

1. 要件

• Python >= 3.10

• サーバー管理権限と特権ゲートウェイインテント（Server Members Intent）を持つDiscordボットトークン。

2. ローカルインストール

pip install -e .

3. 環境設定

以下の環境変数を設定します（または.env / ~/.hermes/.envに追加します）:

DISCORD_BOT_TOKEN=your_bot_token_here
DISCORD_DEFAULT_GUILD_ID=your_server_id_here  # Optional fallback

Hermes Agentの統合

~/.hermes/config.yamlに追加します:

mcp_servers:
  discord_admin:
    command: "/home/kernel/hermes-venv/bin/python3"
    args: ["-m", "discord_admin_mcp.server"]
    env:
      DISCORD_BOT_TOKEN: "your_bot_token_here"

ライセンス

MIT License - 著者: CommanderBiz