MCP Relay Server

🚀 MCP 中繼服務器

MCP 中繼服務器可讓 Claude 向 Discord 頻道發送消息與提示，並接收回復，為信息交互提供便利。

🚀 快速開始

✨ 主要特性

• 支持 Claude 與 Discord 頻道的消息交互。
• 提供 send-message 工具，支持不同類型的消息發送。

📦 安裝指南

創建 Discord 應用程序和機器人

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

   ⚠️ 重要提示

   請務必安全保管此令牌！不要公開分享。

5. 在 “Privileged Gateway Intents”（特權網關意圖）中啟用：
   • 消息內容意圖
   • 服務器成員意圖
   • 上線意圖

邀請機器人加入您的服務器

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

獲取頻道 ID

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

配置 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 // 示例：60秒超時
}

📚 詳細文檔

注意事項

• 消息內容最長可支持 32,768 字節。
• 支持的文件類型包括但不限於：PDF、DOCX、PPTX、ZIP、PNG、JPG 等。