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 文件。