MCP-Discord

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

概要

MCP-Discordは、以下のDiscord関連機能を提供します：

• Discordボットへのログイン

• ボットが参加しているサーバーの一覧表示

• サーバー情報の取得

• メンバーの一覧表示と詳細情報の確認

• ロールの作成、編集、削除、割り当て、解除

• サーバー内のメッセージ検索

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

• 指定したチャンネルへのメッセージ送信

• フォーラムチャンネル一覧の取得

• フォーラム投稿の作成、更新、削除、返信

• フォーラムスレッドの一覧表示とタグ管理

• テキスト、フォーラム、ボイスチャンネルおよびカテゴリーの作成、編集、削除

• チャンネルの権限オーバーライドの設定と削除

• メッセージへのリアクション追加/削除

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

Related MCP server: MCP-Discord

目次

• 前提条件

• インストール

• 設定

• ツールドキュメント

  • 基本機能

  • チャンネル管理

  • フォーラム機能

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

  • Webhook管理

  • ロール管理

  • メンバー管理

• 開発

• ライセンス

前提条件

• Node.js (v18.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パッケージを確認してください。

Smithery経由でのインストール

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

Docker経由でのインストール

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

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

Dockerはデフォルトで build/app.js を介してストリーミング可能なHTTPサーバーを使用します。

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

# Run HTTP server on port 8080
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 8080:8080 barryy625/mcp-discord:latest

# Override the listening port if needed
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 3000:3000 barryy625/mcp-discord:latest --transport http --port 3000

利用可能なタグ:

• latest - メインブランチからの最新の安定版

• v1.3.8 など - 特定のバージョンリリース

手動インストール

# 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/app.js --transport http --port 3000 --config "your_discord_bot_token"

Claude/Cursorでの使用

1. Claude/Cursorでstdioトランスポートを使用する

MCPクライアントがコマンドベースのstdioサーバーを期待している場合は build/index.js を使用してください。

Claude Desktop / Claude Code

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

Cursor

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

これは、ローカルのコマンドベースのMCPクライアントに推奨されるセットアップです。

2. ストリーミング可能なHTTPサーバーをセルフホストする

mcp-discordをHTTP MCPサーバーとして実行したい場合は build/app.js を使用してください。

Node.jsで実行

DISCORD_TOKEN=your_discord_bot_token node build/app.js --transport http --port 3000

Windows PowerShellの場合:

$env:DISCORD_TOKEN="your_discord_bot_token"
node build/app.js --transport http --port 3000

Dockerで実行

docker run -e DISCORD_TOKEN=your_discord_bot_token -p 3000:3000 barryy625/mcp-discord:latest --transport http --port 3000

起動すると、MCP HTTPエンドポイントは以下のようになります:

http://localhost:3000/mcp

3. ホストされているHTTP MCPサーバーに接続する

mcp-discordを別の場所でホストしている場合は、build/app.js をコマンドとして起動する代わりに、MCPクライアントをサーバーの /mcp エンドポイントに向けてください。

エンドポイントの例:

https://your-server.example.com/mcp

重要な注意点:

• build/app.js はHTTPサーバーを起動します。stdioとは通信しません。

• build/index.js は、コマンドベースのstdio MCPクライアントにとって正しいエントリポイントです。

• ホストされたHTTPを使用する場合は、デプロイメントによって提供されるHTTPエンドポイントURLに接続するようにMCPクライアントを設定してください。

• 正確なHTTPクライアント設定形式は、使用するMCPクライアントによって異なります。

ツールドキュメント

基本機能

• discord_login: 設定されたトークンを使用してDiscordにログイン

• discord_list_servers: ボットが参加しているすべてのDiscordサーバーを一覧表示

• discord_send: 指定したチャンネルにメッセージを送信

• discord_get_server_info: Discordサーバー情報を取得

チャンネル管理

• discord_create_text_channel: テキストチャンネルを作成

• discord_create_forum_channel: フォーラムチャンネルを作成

• discord_create_voice_channel: ボイスチャンネルを作成

• discord_edit_channel: チャンネル名、トピック、親カテゴリー、または位置を編集

• discord_delete_channel: チャンネルを削除

• discord_create_category: チャンネルカテゴリーを作成

• discord_edit_category: チャンネルカテゴリーを編集

• discord_delete_category: チャンネルカテゴリーを削除

• discord_set_channel_permissions: チャンネル/カテゴリー上のロールまたはユーザーの権限オーバーライドを設定

• discord_remove_channel_permissions: チャンネル/カテゴリーから権限オーバーライドを削除

フォーラム機能

• discord_get_forum_channels: フォーラムチャンネルの一覧を取得

• discord_create_forum_post: フォーラム投稿を作成

• discord_get_forum_post: フォーラム投稿を取得

• discord_list_forum_threads: フォーラムチャンネル内のアクティブおよびアーカイブされたスレッドを一覧表示

• discord_reply_to_forum: フォーラム投稿に返信

• discord_get_forum_tags: フォーラムチャンネルで利用可能なすべてのタグを取得

• discord_set_forum_tags: フォーラムチャンネルで利用可能なタグを置換

• discord_update_forum_post: フォーラム投稿のタイトル、タグ、アーカイブ状態、またはロック状態を更新

• discord_delete_forum_post: フォーラム投稿を削除

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

• discord_search_messages: サーバー内のメッセージを検索

• discord_read_messages: チャンネルメッセージを読み取り (before, after, around パラメータをサポート — スノーフレークIDまたはISO 8601形式の日付 "2025-03-01T00:00:00Z" を受け付けます)

• discord_edit_message: ボットが作成したメッセージを編集

• 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を削除

ロール管理

• discord_list_roles: サーバー内のすべてのロールを一覧表示

• discord_create_role: 色、ホイスト、メンション可能、および権限オプションを指定してロールを作成

• discord_edit_role: 既存のロールを編集

• discord_delete_role: ロールを削除

• discord_assign_role: メンバーにロールを割り当て

• discord_remove_role: メンバーからロールを削除

メンバー管理

• discord_list_members: ロールを持つサーバー内のメンバーを一覧表示

• discord_get_member: 特定のメンバーに関する詳細情報を取得

開発

# Development mode
npm run dev

ライセンス

MIT License