MCP Discord

🚀 MCP-Discord

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

🚀 クイックスタート

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

• Discordボットにログインする
• サーバー情報を取得する
• チャンネルメッセージを読み取り/削除する
• 指定したチャンネルにメッセージを送信する
• フォーラムチャンネルリストを取得する
• フォーラム投稿を作成/削除/返信する
• テキストチャンネルを作成/削除する
• メッセージにリアクションを追加/削除する
• ウェブフックを作成/編集/削除/使用する

📚 ドキュメント

目次

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

前提条件

• Node.js (v16.0.0以上)
• npm (v7.0.0以上)
• 適切な権限を持つDiscordボット
  • ボットトークン（Discord Developer Portalから取得可能）
  • メッセージコンテンツインテントを有効にする
  • サーバーメンバーインテントを有効にする
  • プレゼンスインテントを有効にする
• Discordサーバーでの権限：
  • メッセージを送信する
  • 公開スレッドを作成する
  • スレッド内でメッセージを送信する
  • スレッドを管理する
  • チャンネルを管理する
  • リアクションを追加する

インストール

Smitheryを介したインストール

Smitheryを介してClaude Desktop用にmcp-discordを自動的にインストールするには、次のコマンドを実行します。

npx -y @smithery/cli install @barryyip0625/mcp-discord --client claude

手動インストール

# リポジトリをクローンする
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord

# 依存関係をインストールする
npm install

# TypeScriptをコンパイルする
npm run build

設定

適切な動作にはDiscordボットトークンが必要です。以下の2つの方法で提供できます。

1. 環境変数を使用する：

DISCORD_TOKEN=your_discord_bot_token
DEFAULT_SERVER_ID=your_default_server_id  # オプション
DEFAULT_CHANNEL_ID=your_default_channel_id  # オプション

2. 起動時に--configパラメータを使用する：

node path/to/mcp-discord/build/index.js --config "{\"DISCORD_TOKEN\":\"your_discord_bot_token\"}"

拡張起動スクリプト

このプロジェクトには、デバッグとエラーハンドリングが向上した拡張起動スクリプト (start-discord.js) が含まれています。

• .envファイルから環境変数を読み込む
• 提供されていない場合、デフォルトのサーバーとチャンネルIDを設定する
• Claude DesktopでのJSON解析エラーを避けるために、console.logをstderrにリダイレクトする
• MCPサーバーを起動する前に直接Discord接続をテストする
• 何かがうまくいかない場合、詳細なエラー情報を提供する

このスクリプトを使用するには、次のコマンドを実行します。

node start-discord.js

Claude/Cursorでの使用方法

• Claude

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/start-discord.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token",
                "DEFAULT_SERVER_ID": "your_default_server_id",
                "DEFAULT_CHANNEL_ID": "your_default_channel_id"
            }
        }
    }
}

• Cursor

{
    "mcpServers": {
        "discord": {
            "command": "cmd",
            "args": [
                "/c",
                "node",
                "path/to/mcp-discord/start-discord.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token",
                "DEFAULT_SERVER_ID": "your_default_server_id",
                "DEFAULT_CHANNEL_ID": "your_default_channel_id"
            }
        }
    }
}

ツールドキュメント

基本機能

• discord_login：Discordにログインする
• discord_list_guilds：すべての利用可能なDiscordサーバー（ギルド）とそのチャンネルをリストする
• discord_send：指定したチャンネルにメッセージを送信する
• 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：チャンネルから特定のメッセージを削除する

ウェブフック管理

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

開発

# 開発モード
npm run dev

ライセンス

MIT License