Discord Relay

🚀 MCP 中繼服務器

MCP 中繼服務器允許 Claude 向 Discord 頻道發送消息和提示，並接收來自該頻道的響應，為信息交互提供了便利。

🚀 快速開始

✨ 主要特性

• 支持 Claude 與 Discord 頻道之間的消息交互，可發送消息和提示並接收響應。
• 提供 send-message 工具，支持多種消息類型和操作按鈕配置。

📦 安裝指南

1. 創建 Discord 應用程序和機器人

1. 訪問 Discord 開發者控制檯。
2. 點擊“新建應用程序”，併為其命名。
3. 轉到左側邊欄的“機器人”部分。
4. 在機器人的令牌部分下，點擊“重置令牌”，並複製新的令牌。

   ⚠️ 重要提示

   請務必妥善保管此令牌，切勿公開分享。

5. 在“特權網關意圖”下啟用以下選項：
   • 消息內容意圖
   • 服務器成員意圖
   • 用戶在線狀態意圖

2. 邀請機器人到你的服務器

1. 轉到左側邊欄的“OAuth2”部分。
2. 選擇“URL 生成器”。
3. 在“作用域”下，選擇：
   • bot
   • applications.commands
4. 在“機器人權限”下，選擇：
   • 發送消息
   • 嵌入鏈接
   • 閱讀消息歷史記錄
5. 複製生成的 URL，並在瀏覽器中打開。
6. 選擇你的服務器，並授權機器人。

3. 獲取頻道 ID

1. 在 Discord 中，啟用開發者模式：
   • 轉到用戶設置 > 應用設置 > 高級。
   • 打開“開發者模式”。
2. 右鍵點擊你想要使用的頻道。
3. 點擊“複製頻道 ID”。

4. 配置 MCP 設置

服務器需要在你的 MCP 設置文件中進行配置。在你的配置文件中添加以下內容：

{
    "mcpServers": {
        "discord-relay": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/MCP Relay/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_bot_token_here",
                "DISCORD_CHANNEL_ID": "your_channel_id_here"
            }
        }
    }
}

替換說明：

• /ABSOLUTE/PATH/TO/MCP Relay：請替換為你的 MCP 中繼項目的實際路徑。
• your_bot_token_here：請替換為你自己的 Discord 機器人令牌。
• your_channel_id_here：請替換為你自己的 Discord 頻道 ID。

⚠️ 重要提示

請確保在配置中使用絕對路徑。

💻 使用示例

基礎用法

服務器提供了一個名為 send-message 的工具，接受以下參數：

{
  type: 'prompt' | 'notification',  // 消息類型
  title: string,                    // 消息標題
  content: string,                  // 消息內容
  actions?: Array<{                 // 可選操作按鈕
    label: string,                  // 按鈕標籤
    value: string                   // 點擊時返回的值
  }>,
  timeout?: number                  // 可選超時時間（以毫秒為單位）
}

高級用法

通知消息

通知是簡單的不需要回復的消息，示例如下：

{
  "type": "notification",
  "title": "你好",
  "content": "這是一個通知"
}

提示消息

提示是等待回覆的消息，示例如下：

{
  "type": "prompt",
  "title": "問題",
  "content": "你想要繼續嗎？",
  "actions": [
    { "label": "是", "value": "yes" },
    { "label": "否", "value": "no" }
  ],
  "timeout": 60000  // 可選：1 分鐘超時
}

⚠️ 重要提示

• 提示可以通過點擊操作按鈕或發送文本消息來進行回覆。
• 每個提示僅接受一個響應。
• 如果設置了超時，提示將在超時後失敗。
• 通知不會等待回覆，會立即返回。