Discord Mcp

Discord-MCPとは？

Discord-MCPは、AIアシスタントとDiscordプラットフォームとのシームレスな相互作用を可能にする強力なサーバーです。このツールは、さまざまなタスクを自動化し、Discordコミュニティ内でのコミュニケーションとエンゲージメントを効率化する高度な機能を提供することで、ユーザー体験を向上させます。

Discord-MCPの特徴

• AI統合：AIアシスタントがDiscordと直接対話できるようにし、リアルタイムでの応答と支援を提供します。
• 自動化機能：繰り返しのタスクを自動化し、ユーザーがDiscordサーバーを管理しやすくします。
• ユーザーフレンドリーなインターフェース：シンプルさを重視して設計されており、すべてのスキルレベルのユーザーがアクセス可能です。
• オープンソース：公開リポジトリであるため、ユーザーはその開発に貢献し、自分のニーズに合わせてカスタマイズできます。
• コミュニティサポート：Discord-MCPを効果的に使用するためのヒントやトリック、サポートを共有するユーザーと開発者の成長するコミュニティ。

Discord-MCPの使い方

1. インストール：GitHubからリポジトリをクローンし、READMEファイルに記載されたインストール手順に従います。
2. 設定：Discordボットを設定し、サーバーと対話できるように必要な権限を構成します。
3. 統合：AIアシスタントをDiscord-MCPに接続し、コマンドやメッセージに応答できるようにします。
4. カスタマイズ：必要に応じてコードを修正し、機能を特定の要件に合わせて調整します。
5. エンゲージメント：DiscordでAIアシスタントを使用し始め、インタラクションを強化し、タスクを自動化してスムーズな体験を実現します。

よくある質問

Q: Discord-MCPは無料で使用できますか？

A: はい、Discord-MCPはオープンソースプロジェクトであり、無料で使用できます。

Q: プロジェクトに貢献できますか？

A: もちろんです！貢献は大歓迎です。リポジトリをフォークし、変更を加えてプルリクエストを提出できます。

Q: Discord-MCPで使用されているプログラミング言語は何ですか？

A: Discord-MCPは主にJavaScriptとNode.jsで構築されています。

Q: 問題やバグを報告するにはどうすればよいですか？

A: GitHubリポジトリの「Issues」タブで新しいイシューを作成して報告できます。

Q: Discord-MCPのドキュメントはどこにありますか？

A: ドキュメントはリポジトリのREADMEファイルにあり、コミュニティフォーラムやディスカッションを通じても入手できます。

Discord-MCPを利用することで、ユーザーはDiscord体験を大幅に向上させ、インタラクションをより効率的で楽しいものにすることができます。

<div align="center"> <img src="assets/img/Discord_MCP_full_logo.svg" width="60%" alt="DeepSeek-V3" /> </div> <hr> <div align="center" style="line-height: 1;"> <a href="https://github.com/modelcontextprotocol/servers" target="_blank" style="margin: 2px;"> <img alt="MCP Server" src="https://badge.mcpx.dev?type=server" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://smithery.ai/server/@SaseQ/discord-mcp" target="_blank" style="margin: 2px;"> <img alt="Smithery Badge" src="https://camo.githubusercontent.com/ee5c6c6dc502821f4d57313b2885f7878af52be14142dd98526ea12aedf9b260/68747470733a2f2f736d6974686572792e61692f62616467652f40646d6f6e74676f6d65727934302f646565707365656b2d6d63702d736572766572" data-canonical-src="https://smithery.ai/server/@SaseQ/discord-mcp" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://discord.gg/5Uvxe5jteM" target="_blank" style="margin: 2px;"> <img alt="Discord" src="https://img.shields.io/discord/936242526120194108?color=7389D8&label&logo=discord&logoColor=ffffff" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://github.com/SaseQ/discord-mcp/blob/main/LICENSE" target="_blank" style="margin: 2px;"> <img alt="MIT License" src="https://img.shields.io/github/license/SaseQ/discord-mcp" style="display: inline-block; vertical-align: middle;"/> </a> </div>

📖 Description

A Model Context Protocol (MCP) server for the Discord API (JDA), allowing seamless integration of Discord Bot with MCP-compatible applications like Claude Desktop.

Enable your AI assistants to seamlessly interact with Discord. Manage channels, send messages, and retrieve server information effortlessly. Enhance your Discord experience with powerful automation capabilities.

🔬 Installation

► 🐳 Docker Installation (Recommended)

NOTE: Docker installation is required. Full instructions can be found on docker.com.

{
  "mcpServers": {
    "mcp-server": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

<details> <summary style="font-size: 1.35em; font-weight: bold;"> 🔧 Manual Installation </summary>

Clone the repository

git clone https://github.com/SaseQ/discord-mcp

Build the project

NOTE: Maven installation is required to use the mvn command. Full instructions can be found here.

cd discord-mcp
mvn clean package # The jar file will be available in the /target directory

Configure AI client

Many code editors and other AI clients use a configuration file to manage MCP servers.

The Discord MPC server can be configured by adding the following to your configuration file.

NOTE: You will need to create a Discord Bot token to use this server. Instructions on how to create a Discord Bot token can be found here.

{
  "mcpServers": {
    "discord-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/discord-mcp-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN",
        "DISCORD_GUILD_ID": "OPTIONAL_DEFAULT_SERVER_ID"
      }
    }
  }
}

The DISCORD_GUILD_ID environment variable is optional. When provided, it sets a default Discord server ID so any tool that accepts a guildId parameter can omit it.

</details> <details> <summary style="font-size: 1.35em; font-weight: bold;"> ⚓ Smithery Installation </summary>

Install Discord MCP Server automatically via Smithery:

npx -y @smithery/cli@latest install @SaseQ/discord-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

</details> <details> <summary style="font-size: 1.35em; font-weight: bold;"> 🖲 Cursor Installation </summary>

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Pasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.

{
  "mcpServers": {
    "mcp-server": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

</details> <details> <summary style="font-size: 1.35em; font-weight: bold;"> ⌨️ Claude Code Installation </summary>

Run this command. See Claude Code MCP docs for more info.

claude mcp add mcp-server -- docker run --rm -i -e DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN> -e DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID> saseq/discord-mcp:latest

</details>

🛠️ Available Tools

Server Information

• get_server_info: Get detailed discord server information

User Management

• get_user_id_by_name: Get a Discord user's ID by username in a guild for ping usage <@id>
• send_private_message: Send a private message to a specific user
• edit_private_message: Edit a private message from a specific user
• delete_private_message: Delete a private message from a specific user
• read_private_messages: Read recent message history from a specific user

Message Management

• send_message: Send a message to a specific channel
• edit_message: Edit a message from a specific channel
• delete_message: Delete a message from a specific channel
• read_messages: Read recent message history from a specific channel
• add_reaction: Add a reaction (emoji) to a specific message
• remove_reaction: Remove a specified reaction (emoji) from a message

Channel Management

• create_text_channel: Create text a channel
• delete_channel: Delete a channel
• find_channel: Find a channel type and ID using name and server ID
• list_channels: List of all channels

Category Management

• create_category: Create a new category for channels
• delete_category: Delete a category
• find_category: Find a category ID using name and server ID
• list_channels_in_category: List of channels in a specific category

Webhook Management

• create_webhook: Create a new webhook on a specific channel
• delete_webhook: Delete a webhook
• list_webhooks: List of webhooks on a specific channel
• send_webhook_message: Send a message via webhook

If DISCORD_GUILD_ID is set, the guildId parameter becomes optional for all tools above.

<hr>

A more detailed examples can be found in the Wiki.