Discord MCP Server

Discord MCP Server

site icon
2025.04.01 48
PythonDiscord集成聊天机器人自动化管理交流协作
mcp-discord 是一个基于 Model Context Protocol (MCP) 的服务,专门为 MCP 客户端(如 Claude Desktop)提供 Discord 集成功能。它允许用户通过 MCP 协议与 Discord 服务器进行交互,包括消息管理、频道管理、角色管理和 Webhook 管理等核心功能。
View on GitHub

Overview

基本能力

产品定位

mcp-discord 是一个 Discord 集成服务,旨在通过 MCP 协议为客户端提供 Discord 的全面交互能力。

核心功能

  1. 服务器信息管理
  2. 获取服务器详细信息
  3. 列出服务器成员及其角色

  4. 消息管理

  5. 发送消息到频道
  6. 读取最近的消息历史
  7. 添加/移除消息反应
  8. 删除消息和用户超时

  9. 频道管理

  10. 创建新的文本频道
  11. 删除现有频道

  12. 角色管理

  13. 为用户添加角色
  14. 移除用户角色

  15. Webhook 管理

  16. 创建和管理 Webhook
  17. 通过 Webhook 发送消息

适用场景

  • 在 MCP 客户端中集成 Discord 功能
  • 自动化 Discord 服务器管理
  • 通过 Webhook 实现消息自动化

使用教程

使用依赖

  1. 创建 Discord 应用并获取 Bot Token:
  2. 访问 Discord Developer Portal
  3. 创建 Bot 并复制 Token
  4. 启用以下特权意图:
    • MESSAGE CONTENT INTENT
    • PRESENCE INTENT
    • SERVER MEMBERS INTENT

安装教程

  1. 通过 Smithery 自动安装:
npx -y @smithery/cli install @hanweg/mcp-discord --client claude
  1. 手动安装:
git clone https://github.com/hanweg/mcp-discord.git
cd mcp-discord
uv venv
.venv\Scripts\activate
uv pip install -e .
  1. 配置 Claude Desktop: 编辑配置文件 (%APPDATA%\Claude\claude_desktop_config.json~/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"
  }
}

调试方式

  1. 确保 Bot Token 正确配置
  2. 检查特权意图是否启用
  3. 验证 Bot 是否已加入目标服务器
  4. 检查 Claude Desktop 配置是否正确

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。