Danushkumar-V-mcp-discord

MCP-Discord

AI アシスタントが Discord プラットフォームとやり取りできるようにする、Discord MCP（Model Context Protocol）サーバーです。

概要

MCP-Discord は、Discord 関連の次の機能を提供します。

• Discord ボットにログインする
• サーバー情報を取得する
• チャンネルのメッセージを読み取る／削除する
• 指定したチャンネルにメッセージを送信する（チャンネル ID またはチャンネル名を使用）
• フォーラムチャンネルの一覧を取得する
• フォーラム投稿を作成／削除／返信する
• テキストチャンネルを作成／削除する
• メッセージのリアクションを追加／削除する
• Webhook を作成／編集／削除／使用する

目次

• 前提条件
• インストール
• 設定
• ツールのドキュメント
  • 基本機能
  • チャンネル管理
  • フォーラム機能
  • メッセージとリアクション
  • Webhook 管理
• 開発
• ライセンス

前提条件

• Node.js（v16.0.0 以上）

• npm（v7.0.0 以上）

• 適切な権限を持つ Discord ボット

  • ボットトークン（Discord Developer Portalから取得できます）
  • Message Content Intent が有効
  • Server Members Intent が有効
  • Presence Intent が有効

• Discord サーバーで必要な権限：

  最も簡単な設定

  • 管理者（すばやい設定とすべての機能の利用に推奨）

  または、必要な権限のみを選択：

  • メッセージを送信
  • パブリックスレッドを作成
  • スレッドでメッセージを送信
  • メッセージを管理
  • スレッドを管理
  • チャンネルを管理
  • Webhook を管理
  • リアクションを追加
  • チャンネルを表示

• Discord ボットをサーバーに追加する

  • Discord ボットをサーバーに追加するには、次の招待リンクのいずれかを使用します（INSERT_CLIENT_ID_HERE をボットのクライアント ID に置き換えてください）：
    • 管理者（フルアクセス）： https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=8
    • カスタム権限（必要最小限）： https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=52076489808

注：
Discord のセキュリティモデルにより、ボットがアクセスできるのは、明示的に追加されたサーバーの情報に限られます。
この MCP サーバーを使って特定の Discord サーバーにアクセスするには、まずボットをそのサーバーに追加する必要があります。
以下の招待リンクを使用して、対象のサーバーにボットを追加してください。

インストール

NPM を使用したインストール

次のコマンドで使用できます：

npx mcp-discord --config ${DISCORD_TOKEN}

詳細については、NPM Packageをご覧ください。

Smithery を使用したインストール

Smithery を介して mcp-discord を自動的にインストールするには

Docker を使用したインストール

Docker を使用して mcp-discord を実行できます。Docker イメージは自動的にビルドされ、Docker Hub に公開されます。

Docker Hub リポジトリ：barryy625/mcp-discord

# Pull the latest image
docker pull barryy625/mcp-discord:latest

# Run with environment variable
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 8080:8080 barryy625/mcp-discord:latest

# Or run with command line config
docker run -p 8080:8080 barryy625/mcp-discord:latest --config "your_discord_bot_token"

利用可能なタグ：

• latest - main ブランチの最新の安定版
• v1.3.3 など - 特定のバージョンリリース

手動インストール

# Clone the repository
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord

# Install dependencies
npm install

# Compile TypeScript
npm run build

設定

適切に動作させるには、Discord ボットトークンが必要です。このサーバーは、stdio と streamable HTTP の 2 つのトランスポート方式に対応しています。

トランスポート方式

1. stdio（デフォルト）

   • 基本的な使用向けの従来の stdio トランスポート
   • シンプルな統合に適しています

2. ストリーム可能な HTTP

   • より高度なシナリオ向けの HTTP ベースのトランスポート
   • ステートレスな動作をサポートします
   • ポート番号を設定できます

設定オプション

設定は次の 2 つの方法で指定できます。

1. 環境変数：

DISCORD_TOKEN=your_discord_bot_token

2. コマンドライン引数を使用：

# For stdio transport (default)
node build/index.js --config "your_discord_bot_token"

# For streamable HTTP transport
node build/index.js --transport http --port 3000 --config "your_discord_bot_token"

Claude/Cursor での使用方法

Docker

Claude と Cursor のどちらでも Docker コンテナを使用できます。

{
    "mcpServers": {
        "discord": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-e",
                "DISCORD_TOKEN=your_discord_bot_token",
                "-p",
                "8080:8080",
                "barryy625/mcp-discord:latest",
                "--transport",
                "http",
                "--port",
                "8080"
            ]
        }
    }
}

Claude

1. stdio トランスポートを使用：

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}

2. ストリーム可能な HTTP トランスポートを使用：

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js",
                "--transport",
                "http",
                "--port",
                "3000",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}

Cursor

1. stdio トランスポートを使用：

{
    "mcpServers": {
        "discord": {
            "command": "cmd",
            "args": [
                "/c",
                "node",
                "path/to/mcp-discord/build/index.js",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}

2. ストリーム可能な HTTP トランスポートを使用：

{
    "mcpServers": {
        "discord": {
            "command": "cmd",
            "args": [
                "/c",
                "node",
                "path/to/mcp-discord/build/index.js",
                "--transport",
                "http",
                "--port",
                "3000",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}

ツールのドキュメント

基本機能

• discord_send：指定したチャンネルにメッセージを送信します（チャンネル ID とチャンネル名の両方に対応）
• discord_get_server_info：Discord サーバーの情報を取得します

チャンネル管理

• discord_create_text_channel：テキストチャンネルを作成します
• discord_delete_channel：チャンネルを削除します

フォーラム機能

• discord_get_forum_channels：フォーラムチャンネルの一覧を取得します
• discord_create_forum_post：フォーラム投稿を作成します
• discord_get_forum_post：フォーラム投稿を取得します
• discord_reply_to_forum：フォーラム投稿に返信します
• discord_delete_forum_post：フォーラム投稿を削除します

メッセージとリアクション

• discord_read_messages：チャンネルのメッセージを読み取ります
• discord_add_reaction：メッセージにリアクションを追加します
• discord_add_multiple_reactions：メッセージに複数のリアクションを追加します
• discord_remove_reaction：メッセージからリアクションを削除します
• discord_delete_message：チャンネルから特定のメッセージを削除します

Webhook の管理

• discord_create_webhook：Discord チャンネル用の新しい Webhook を作成します
• discord_send_webhook_message：Webhook を使用して Discord チャンネルにメッセージを送信します
• discord_edit_webhook：Discord チャンネル用の既存の Webhook を編集します
• discord_delete_webhook：Discord チャンネル用の既存の Webhook を削除します

開発

# Development mode
npm run dev

ライセンス

MIT ライセンス