金大哥 - mcp-discord MCP 详情

article

README

🚀 Discord MCP 服务器

一个提供 Discord 集成功能的 Model Context Protocol (MCP) 服务器，适用于像 Claude Desktop 这样的 MCP 客户端。借助该服务器，能让 Claude Desktop 等客户端更好地与 Discord 进行交互，拓展使用场景。

🚀 快速开始

本 Discord MCP 服务器为 MCP 客户端（如 Claude Desktop）提供了丰富的 Discord 集成功能。下面将详细介绍服务器的可用工具、安装步骤等内容。

✨ 主要特性

可用工具

服务器信息

get_server_info：可获取详细的服务器信息，助你全面了解服务器状态。
list_members：能列出服务器成员及其角色，方便进行成员管理。

消息管理

send_message：可向频道发送消息，实现信息的及时传递。
read_messages：用于阅读最近的消息历史，便于回顾交流内容。
add_reaction：能在消息上添加反应，增加互动性。
add_multiple_reactions：可向消息添加多个反应，丰富互动形式。
remove_reaction：从消息中移除反应，灵活管理互动效果。
moderate_message：删除消息并对用户设置超时，实现消息的有效管理。

频道管理

create_text_channel：创建新的文本频道，满足多样化的交流需求。
delete_channel：删除现有的频道，优化频道结构。

角色管理

add_role：向用户添加角色，合理分配权限。
remove_role：从用户移除角色，灵活调整权限设置。

Webhook 管理

create_webhook：创建一个新的 webhook，实现自动化消息推送。
list_webhooks：列出频道中的 webhooks，方便管理。
send_webhook_message：通过 webhook 发送消息，提高消息传递效率。
modify_webhook：更新 webhook 的设置，满足不同的使用场景。
delete_webhook：删除一个 webhook，清理不再使用的配置。

📦 安装指南

通过 Smithery 安装

使用 Smithery 可自动安装 Discord 服务器以适用于 Claude Desktop，操作命令如下：

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

手动安装步骤

设置你的 Discord 机器人：
- 在 Discord 开发者控制台创建一个新的应用程序。
- 创建一个机器人并复制令牌。
- 启用所需的特权意图：
  - 消息内容意图
  - 用户状态意图
  - 服务器成员意图
- 使用 OAuth2 URL 生成器将机器人邀请到你的服务器。
克隆并安装包：

# 克隆仓库
git clone https://github.com/hanweg/mcp-discord.git
cd mcp-discord

# 创建并激活虚拟环境
uv venv
.venv\Scripts\activate

### 如果使用 Python 3.13+ - 安装 audioop 库：`uv pip install audioop-lts`

# 安装包
uv pip install -e .

配置 Claude Desktop：在 Windows 上配置文件路径为 %APPDATA%\Claude\claude_desktop_config.json，在 macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，配置内容如下：

    "discord": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\PATH\\TO\\mcp-discord",
        "run",
        "mcp-discord"
      ],
      "env": {
        "DISCORD_TOKEN": "your_bot_token"
      }
    }

📄 许可证

本项目采用 MIT License，有关详细信息，请参见 LICENSE 文件。

mcp-discord