
Discord MCP Server

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交互应用
工具列表
get_server_info
:获取服务器详细信息list_members
:列出服务器成员send_message
:发送消息read_messages
:读取消息历史add_reaction
:添加反应create_text_channel
:创建文本频道create_role
:创建角色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 .
调试方式
- 确保配置文件中包含正确的Discord token
- 检查默认服务器ID是否正确(如使用)
- 运行服务后测试基本功能如发送消息
配置示例
"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"
}
}