MCP Discord

🚀 MCP-Discord

MCP-Discord 是一個 Discord MCP（模型上下文協議）服務器，它能讓 AI 助手與 Discord 平臺進行交互，為 AI 與 Discord 的集成提供了便利。

🚀 快速開始

前提條件

• Node.js（版本 v16.0.0 或更高）
• npm（版本 v7.0.0 或更高）
• 一個具備適當權限的 Discord 機器人：
  • 機器人令牌（可從 Discord 開發者門戶 獲取）
  • 啟用消息內容意圖
  • 啟用服務器成員意圖
  • 啟用在線狀態意圖
• 在你的 Discord 服務器中具備以下權限：
  • 發送消息
  • 創建公共線程
  • 在線程中發送消息
  • 管理線程
  • 管理頻道
  • 添加反應

安裝

通過 Smithery 安裝

要通過 Smithery 自動為 Claude Desktop 安裝 mcp-discord，請運行以下命令：

npx -y @smithery/cli install @barryyip0625/mcp-discord --client claude

手動安裝

# 克隆倉庫
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord

# 安裝依賴
npm install

# 編譯 TypeScript
npm run build

配置

正常運行需要一個 Discord 機器人令牌，你可以通過以下兩種方式提供：

1. 環境變量：

DISCORD_TOKEN=your_discord_bot_token
DEFAULT_SERVER_ID=your_default_server_id  # 可選
DEFAULT_CHANNEL_ID=your_default_channel_id  # 可選

2. 在啟動時使用 --config 參數：

node path/to/mcp-discord/build/index.js --config "{\"DISCORD_TOKEN\":\"your_discord_bot_token\"}"

增強啟動腳本

項目包含一個增強的啟動腳本 (start-discord.js)，它提供了更好的調試和錯誤處理功能：

• 從 .env 文件加載環境變量
• 如果未提供，則設置默認服務器和頻道 ID
• 將 console.log 重定向到 stderr，以避免 Claude Desktop 中的 JSON 解析問題
• 在啟動 MCP 服務器之前直接測試 Discord 連接
• 如果出現問題，提供詳細的錯誤信息

要使用此腳本，請運行：

node start-discord.js

與 Claude/Cursor 一起使用

• Claude

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/start-discord.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token",
                "DEFAULT_SERVER_ID": "your_default_server_id",
                "DEFAULT_CHANNEL_ID": "your_default_channel_id"
            }
        }
    }
}

• Cursor

{
    "mcpServers": {
        "discord": {
            "command": "cmd",
            "args": [
                "/c",
                "node",
                "path/to/mcp-discord/start-discord.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token",
                "DEFAULT_SERVER_ID": "your_default_server_id",
                "DEFAULT_CHANNEL_ID": "your_default_channel_id"
            }
        }
    }
}

✨ 主要特性

MCP-Discord 提供了以下與 Discord 相關的功能：

• 登錄 Discord 機器人
• 獲取服務器信息
• 讀取/刪除頻道消息
• 向指定頻道發送消息
• 檢索論壇頻道列表
• 創建/刪除/回覆論壇帖子
• 創建/刪除文本頻道
• 添加/移除消息反應
• 創建/編輯/刪除/使用 Webhook

📚 詳細文檔

基本功能

• discord_login：登錄 Discord
• discord_list_guilds：列出所有可用的 Discord 服務器（公會）及其頻道
• discord_send：向指定頻道發送消息
• discord_get_server_info：獲取 Discord 服務器信息

頻道管理

• discord_create_text_channel：創建文本頻道
• discord_delete_channel：刪除頻道

論壇功能

• discord_get_forum_channels：獲取論壇頻道列表
• discord_create_forum_post：創建論壇帖子
• discord_get_forum_post：獲取論壇帖子
• discord_reply_to_forum：回覆論壇帖子
• discord_delete_forum_post：刪除論壇帖子

消息和反應

• discord_read_messages：讀取頻道消息
• discord_add_reaction：為消息添加反應
• discord_add_multiple_reactions：為消息添加多個反應
• discord_remove_reaction：從消息中移除反應
• discord_delete_message：從頻道中刪除特定消息

Webhook 管理

• discord_create_webhook：為 Discord 頻道創建新的 Webhook
• discord_send_webhook_message：使用 Webhook 向 Discord 頻道發送消息
• discord_edit_webhook：編輯 Discord 頻道的現有 Webhook
• discord_delete_webhook：刪除 Discord 頻道的現有 Webhook

💻 使用示例

開發模式

# 開發模式
npm run dev

📄 許可證

MIT 許可證