Discord MCP Server

Discord MCP Server

site icon
2025.04.20 2
PythonDiscord集成服务器管理AI代理接口交流协作
Discord MCP Server 是一个模型上下文协议(MCP)服务器,为AI代理(如Goose、Claude Desktop等)提供Discord集成能力。它允许这些代理通过MCP协议与Discord服务器进行交互,执行各种管理任务和消息操作。
View on GitHub

Overview

基本能力

产品定位

Discord MCP Server 是一个为AI代理提供Discord平台集成的中间件服务,使AI能够管理Discord服务器、频道、成员和消息。

核心功能

  • 服务器信息管理:获取服务器详情、列出成员
  • 消息管理:发送/读取消息、添加/删除反应、消息审核
  • 频道管理:创建/删除文本频道、创建线程、设置权限、创建分类
  • 角色管理:创建/删除角色、列出角色、为用户添加/移除角色
  • 用户管理:获取用户信息、踢出/封禁用户

适用场景

  • AI助手管理Discord社区
  • 自动化Discord服务器管理
  • 构建基于Discord的AI交互应用

工具列表

  1. get_server_info:获取服务器详细信息
  2. list_members:列出服务器成员
  3. send_message:发送消息
  4. read_messages:读取消息历史
  5. add_reaction:添加反应
  6. create_text_channel:创建文本频道
  7. create_role:创建角色
  8. get_user_info:获取用户信息

常见问题

  • 需要有效的Discord bot token才能运行
  • 需要配置Claude Desktop等客户端的配置文件

使用教程

使用依赖

  • Python环境
  • Git
  • uv工具

安装教程

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

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

# 如使用Python 3.13+
uv pip install audioop-lts

# 安装包
uv pip install -e .

调试方式

  1. 确保配置文件中包含正确的Discord token
  2. 检查默认服务器ID是否正确(如使用)
  3. 运行服务后测试基本功能如发送消息

配置示例

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

许可证

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