MCP-Discord

AI アシスタントが Discord プラットフォームと対話できるようにする Discord MCP (Model Context Protocol) サーバー。

概要

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

• Discordボットにログイン

• サーバー情報を取得する

• チャンネルメッセージの読み取り/削除

• 指定されたチャネルにメッセージを送信する（チャネル ID またはチャネル名を使用）

• フォーラムのチャンネルリストを取得する

• フォーラム投稿の作成/削除/返信

• テキストチャンネルの作成/削除

• メッセージ反応の追加/削除

• Webhookの作成/編集/削除/使用

Related MCP server: MCP Toolkit

目次

• 前提条件

• インストール

• 構成

• ツールドキュメント

  • 基本機能

  • チャンネル管理

  • フォーラム機能

  • メッセージと反応

  • Webhook管理

• 発達

• ライセンス

前提条件

• Node.js (v16.0.0 以上)

• npm (v7.0.0 以上)

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

  • ボットトークン（ Discord開発者ポータルから入手可能）

  • メッセージコンテンツインテントが有効

  • サーバーメンバーの意図が有効

  • プレゼンスインテントが有効

• 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 サーバーにアクセスする場合は、まずそのサーバーにボットを追加する必要があります。
以下の招待リンクを使用して、ボットをターゲット サーバーに追加します。

インストール

Smithery経由でインストール

Smithery経由でmcp-discordを自動的にインストールするには

手動インストール

# 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とストリーミング可能な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 との使用

クロード

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"
            ]
        }
    }
}

カーソル

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_login : Discordにログイン

• 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ライセンス