Discord AI助手协议

一个基于MCP协议的Discord服务器,使AI助手能够与Discord平台进行交互,提供消息管理、频道管理、论坛功能和Webhook管理等功能。

  • by jackedelic
  • 混合部署
  • 更新于
在 GitHub 查看 jackedelic/mcp-discord

使用说明

MCP故障

Discord MCP(模型上下文协议)服务器,使AI助手能够与Discord平台进行交互。

概述

MCP Discord提供以下Discord相关功能:

  • 登录Discord机器人
  • 获取服务器信息
  • 读取/删除频道消息
  • 向指定频道发送消息(使用频道ID或频道名称)
  • 检索论坛频道列表
  • 创建/删除/回复论坛帖子
  • 创建/删除文本频道
  • 添加/删除消息反应
  • 创建/编辑/删除/使用webhooks

目录

先决条件

  • Node.js(v16.0.0或更高版本)

  • npm(v7.0.0或更高版本)

  • 具有适当权限的Discord机器人

    • Bot令牌(可从 Discord开发者门户)
    • 消息内容意图已启用
    • 服务器成员意图已启用
    • 已启用存在意图
  • Discord服务器中所需的权限:

    最简单的设置

    • 管理员(建议用于快速设置和完整功能)

    或者,仅选择所需的权限:

    • 发送消息
    • 创建公共线程
    • 在线程中发送消息
    • 管理邮件
    • 管理线程
    • 管理渠道
    • 管理 Webhooks
    • 添加反应
    • 查看频道
  • 将您的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安装

通过以下方式自动安装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。

运输方式

  1. 标准输入输出 (默认)

    • 用于基本用途的传统stdio传输
    • 适用于简单的集成
  2. 可流式传输HTTP

    • 用于更高级场景的基于HTTP的传输
    • 支持无状态操作
    • 可配置的端口号

配置选项

您可以通过两种方式提供配置:

  1. 环境变量:
DISCORD_TOKEN=your_discord_bot_token
  1. 使用命令行参数:
# 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"
            ]
        }
    }
}
  1. 使用流式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"
            ]
        }
    }
}
  1. 使用流式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:从频道中删除特定消息

网钩 管理

  • 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许可证