Discord MCP

🚀 Discord MCP Server

这是一个模型上下文协议（Model Context Protocol） 服务器，它能让AI智能体安全地访问Discord的REST API和网关事件。

🚀 快速开始

# 克隆项目并安装依赖
git clone https://github.com/GustyCube/discord-mcp
cd discord-mcp
npm install

# 配置你的机器人
cp .env.example .env
# 添加你的 DISCORD_BOT_TOKEN 和其他设置

# 构建并运行
npm run build
npm start

✨ 主要特性

• 🔧 120+ 种Discord API工具：全面覆盖Discord的REST API。
• 🔒 安全至上：支持服务器/频道白名单，默认设置安全，避免意外提及。
• ⚡ 实时事件：集成网关，实时获取Discord活动。
• 🎯 智能路由：根据声明式API目录自动生成工具。
• 📦 模块化包：仅启用你需要的功能。

💻 使用示例

基础用法

将以下内容添加到你的 mcp.json 文件中：

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/path/to/discord-mcp/dist/index.js"],
      "env": {
        "DISCORD_BOT_TOKEN": "your_bot_token_here",
        "ALLOW_GUILD_IDS": "123456789,987654321",
        "ALLOW_CHANNEL_IDS": "111111111,222222222"
      }
    }
  }
}

可实现的功能

• 📝 消息管理：发送、编辑、删除消息和反应。
• 👥 用户与服务器信息：获取用户资料、服务器详情、成员列表。
• 🔊 频道操作：列出频道、管理权限、创建线程。
• 🎭 丰富内容：发送嵌入消息、管理Webhook、上传文件。
• ⚡ 实时事件：订阅消息事件、成员加入等。
• 🛡️ 管理功能：管理封禁、踢出、角色（需相应权限）。

📚 详细文档

📖 完整文档请访问 discord-mcp.gustycube.com

快速链接

• 入门指南
• 配置说明
• 可用工具
• 安全模型
• 示例

🤝 贡献代码

有关开发设置、API参考和贡献指南，请参阅完整文档。

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE 文件。