MCP 服务器

Discord Raw API MCP Server

允许直接与 Discord API 交互，使用 REST API 调用和斜杠命令语法进行机器人管理、服务器配置和消息操作。

Tools

discord_api

Execute raw Discord API commands. Supports both REST API calls and application commands.

README

Discord Raw API MCP 服务器

这个 MCP 服务器通过一个灵活的工具提供原始的 Discord API 访问。它支持 REST API 调用和斜杠命令语法。

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Discord Raw API：

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

手动安装

设置你的 Discord 机器人：
- 在 Discord Developer Portal 创建一个新的应用程序
- 创建一个机器人并复制令牌
- 启用所需的特权 intents：
  - MESSAGE CONTENT INTENT (消息内容意图)
  - PRESENCE INTENT (状态意图)
  - SERVER MEMBERS INTENT (服务器成员意图)
- 使用 OAuth2 URL 生成器邀请机器人到你的服务器
克隆并安装包：

# 克隆仓库
git clone https://github.com/hanweg/mcp-discord-raw.git
cd mcp-discord-raw

# 创建并激活虚拟环境
uv venv
.venv\Scripts\activate

### 如果使用 Python 3.13+ - 安装 audioop 库: `uv pip install audioop-lts`

# 安装包
uv pip install -e .

配置

将此添加到你的 claude_desktop_config.json

    "discord-raw": {
      "command": "uv",
      "args": [
        "--directory", 
        "PATH/TO/mcp-discord-raw",
        "run",
        "discord-raw-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR-BOT-TOKEN"
      }
    }

用法

REST API 风格

{
    "method": "POST",
    "endpoint": "guilds/123456789/roles",
    "payload": {
        "name": "Bot Master",
        "permissions": "8",
        "color": 3447003,
        "mentionable": true
    }
}

斜杠命令风格

{
    "method": "POST",
    "endpoint": "/role create name:Bot_Master color:blue permissions:8 mentionable:true guild_id:123456789"
}

示例

创建一个角色：

{
    "method": "POST",
    "endpoint": "/role create name:Moderator color:red permissions:moderate_members guild_id:123456789"
}

发送一条消息：

{
    "method": "POST",
    "endpoint": "channels/123456789/messages",
    "payload": {
        "content": "Hello from the API!"
    }
}

获取服务器信息：

{
    "method": "GET",
    "endpoint": "guilds/123456789"
}

建议：

将服务器、频道和用户 ID 以及一些示例放入项目知识中，以避免必须提醒模型这些信息，以及类似以下内容以开始：

"以下是如何有效使用 Discord 原始 API 工具：该工具名为 discord_api，接受三个参数：

method: HTTP 方法 ("GET", "POST", "PUT", "PATCH", "DELETE")
endpoint: Discord API 端点 (例如, "guilds/{guild.id}/roles")
payload: 请求体的可选 JSON 对象我使用过的关键示例：
创建角色：

discord_api
method: POST
endpoint: guilds/{server_id}/roles
payload: {
    "name": "角色名称",
    "color": 3447003,  // 十进制的蓝色
    "mentionable": true
}

创建类别和频道：

// 类别
discord_api
method: POST
endpoint: guilds/{server_id}/channels
payload: {
    "name": "类别名称",
    "type": 4  // 4 = 类别
}
// 类别中的文本频道
discord_api
method: POST
endpoint: guilds/{server_id}/channels
payload: {
    "name": "频道名称",
    "type": 0,  // 0 = 文本频道
    "parent_id": "类别ID",
    "topic": "频道描述"
}

将频道移动到类别：

discord_api
method: PATCH
endpoint: channels/{channel_id}
payload: {
    "parent_id": "类别ID"
}

发送消息：

discord_api
method: POST
endpoint: channels/{channel_id}/messages
payload: {
    "content": "带有表情符号的消息文本 \ud83d\ude04"
}

分配角色：

discord_api
method: PUT
endpoint: guilds/{server_id}/members/{user_id}/roles/{role_id}
payload: {}

该工具支持完整的 Discord API，因此您可以参考 Discord API 文档以获取更多端点和功能。响应包括 ID 和其他元数据，您可以在后续请求中使用。专业提示：

保存从创建请求返回的 ID，以便在后续请求中使用
~~Unicode 表情符号可以直接包含在消息内容中~~ ？告诉模型使用 discord 表情符号，例如 :champagne_glass: - 带有 unicode 表情符号的消息会使 Claude Desktop 挂起？
频道类型：0 = 文本，2 = 语音，4 = 类别，13 = 舞台
角色颜色为十进制格式（不是十六进制）
大多数修改端点使用 PATCH 方法
空负载应为 {} 而不是 null"