MCP Discord Raw

🚀 Discord 原始 API MCP 服務器

此 MCP 服務器藉助一個靈活的工具，提供對原始 Discord API 的訪問。它支持 REST API 調用以及 Slash 命令語法。

🚀 快速開始

本 MCP 服務器可讓你方便地訪問原始 Discord API，支持多種交互方式，助你輕鬆與 Discord 進行集成。

✨ 主要特性

• 提供原始 Discord API 訪問。
• 支持 REST API 調用和 Slash 命令語法。

📦 安裝指南

通過 Smithery 安裝

要自動通過 Smithery 為 Claude Desktop 安裝 Discord 原始 API，可執行以下命令：

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

手動安裝

1. 設置 Discord 機器人：
   • 在 Discord 開發者控制檯 創建一個新的應用。
   • 為應用創建一個機器人用戶，並獲取其令牌。
2. 安裝依賴項並設置項目結構：

git clone https://github.com/yourusername/mcp-discord-raw.git
cd mcp-discord-raw
npm install

3. 配置 Discord API 的環境變量：
   • 創建一個 .env 文件，並添加以下內容（將 YOUR_DISCORD_TOKEN 替換為你自己的令牌）：

DISCORD_TOKEN=your_discord_token_here

4. 運行服務器：

npm start

📚 詳細文檔

配置

在 config.json 文件中，添加以下配置以啟用 Discord 原始 API 支持：

{
  "apiEndpoints": {
    "discord": {
      "url": "https://discord.com/api/v9"
    }
  },
  "botConfig": {
    "token": "your_discord_token_here",
    "prefix": "/"
  }
}

使用方法

REST API 風格

使用 raw 命令與 Discord API 進行交互：

{
  "command": "raw",
  "endpoint": "/users/{user_id}",
  "method": "GET",
  "headers": {
    "Authorization": "Bearer your_discord_token_here"
  }
}

Slash Command 風格

使用 slash 命令創建和管理 Slash 命令：

{
  "command": "slash",
  "name": "ping",
  "description": "測試機器人是否正常運行。",
  "options": []
}

示例

創建頻道

使用以下 JSON 請求創建一個新頻道：

{
  "command": "raw",
  "endpoint": "/guilds/{guild_id}/channels",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer your_discord_token_here"
  },
  "body": {
    "name": "new-channel-name",
    "type": 0
  }
}

發送消息

使用以下 JSON 請求向指定頻道發送消息：

{
  "command": "raw",
  "endpoint": "/channels/{channel_id}/messages",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer your_discord_token_here"
  },
  "body": {
    "content": "Hello, Discord!"
  }
}

推薦內容

• 保存 ID：創建請求返回的 ID 以便後續使用。
• Unicode 表情符號：直接在消息中包含 Unicode 表情符號（如 \:champagne_glass:）可能會導致 Claude Desktop 掛起，請告知模型使用 Discord 表情符號。
• 頻道類型：0 = 文本，2 = 語音，4 = 類別，13 = 舞臺
• 角色顏色：以十進制格式表示（非十六進制）
• 大多數修改端點：使用 PATCH 方法
• 空有效負載：應為 {} 而不是 null

📄 許可證

本項目採用 MIT License 進行許可。