MCP-Discord

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

概要

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

• Discordボットにログイン

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

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

• 指定されたチャネルにメッセージを送信する

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

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

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

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

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

Related MCP server: MCP-Discord

目次

• 前提条件

• インストール

• 構成

• ツールドキュメント

  • 基本機能

  • チャンネル管理

  • フォーラム機能

  • メッセージと反応

  • Webhook管理

• 発達

• ライセンス

前提条件

• Node.js (v16.0.0 以上)

• npm (v7.0.0 以上)

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

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

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

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

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

• Discord サーバーでの権限:

  • メッセージを送信

  • 公開スレッドを作成する

  • スレッドでメッセージを送信する

  • スレッドを管理する

  • チャンネルを管理する

  • 反応を追加する

インストール

Smithery経由でインストール

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

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

手動インストール

# 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ボットトークンは正常に動作するために必要です。トークンは以下の2つの方法で提供できます。

1. 環境変数:

DISCORD_TOKEN=your_discord_bot_token
DEFAULT_SERVER_ID=your_default_server_id  # Optional
DEFAULT_CHANNEL_ID=your_default_channel_id  # Optional

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 との使用

• クロード

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

• カーソル

  {
      "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 : チャンネルから特定のメッセージを削除する

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