MCP Discord

🚀 Discord MCP 服務器

一個提供 Discord 集成功能的 Model Context Protocol (MCP) 服務器，適用於像 Claude Desktop 這樣的 MCP 客戶端，能為用戶帶來便捷的 Discord 交互體驗。

🚀 快速開始

本 Discord MCP 服務器提供了豐富的工具，可幫助你在 Discord 中進行各種操作。下面為你詳細介紹這些工具。

✨ 主要特性

可用工具

服務器信息

• get_server_info：獲取詳細的服務器信息。
• list_members：列出服務器成員及其角色。

消息管理

• send_message：向頻道發送消息。
• read_messages：閱讀最近的消息歷史。
• add_reaction：在消息上添加反應。
• add_multiple_reactions：向消息添加多個反應。
• remove_reaction：從消息中移除反應。
• moderate_message：刪除消息並對用戶設置超時。

頻道管理

• create_text_channel：創建新的文本頻道。
• delete_channel：刪除現有的頻道。

角色管理

• add_role：向用戶添加角色。
• remove_role：從用戶移除角色。

Webhook 管理

• create_webhook：創建一個新的 webhook。
• list_webhooks：列出頻道中的 webhooks。
• send_webhook_message：通過 webhook 發送消息。
• modify_webhook：更新 webhook 的設置。
• delete_webhook：刪除一個 webhook。

📦 安裝指南

通過 Smithery 安裝

使用 Smithery 自動安裝 Discord 服務器以適用於 Claude Desktop：

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

手動安裝步驟

1. 設置你的 Discord 機器人：
   • 在 Discord 開發者控制檯 創建一個新的應用程序。
   • 創建一個機器人並複製令牌。
   • 啟用所需的特權意圖：
     • 消息內容意圖
     • 用戶狀態意圖
     • 服務器成員意圖
   • 使用 OAuth2 URL 生成器將機器人邀請到你的服務器。
2. 克隆並安裝包：

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

# 創建並激活虛擬環境
uv venv
.venv\Scripts\activate

### 如果使用 Python 3.13+ - 安裝 audioop 庫：`uv pip install audioop-lts`

# 安裝包
uv pip install -e .

3. 配置 Claude Desktop： 在 Windows 上路徑為 %APPDATA%\Claude\claude_desktop_config.json，在 macOS 上路徑為 ~/Library/Application Support/Claude/claude_desktop_config.json，配置內容如下：

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

📄 許可證

本項目採用 MIT License，有關詳細信息，請參見 LICENSE 文件。