Discord Raw API MCP Server

基本能力

产品定位

mcp-discord-raw 是一个专门为 Discord 开发者设计的工具，提供对 Discord API 的直接访问能力，支持 REST API 调用和斜杠命令语法。

核心功能

• 支持 Discord REST API 的直接调用
• 支持斜杠命令语法
• 提供灵活的配置选项，可集成到 Claude Desktop 中
• 支持多种 HTTP 方法（GET, POST, PUT, PATCH, DELETE）

适用场景

• 自动化 Discord 服务器管理（如创建角色、频道等）
• 开发 Discord 机器人
• 集成 Discord 功能到其他应用中

工具列表

• discord_api: 主要工具，用于执行 Discord API 调用
• 参数：
  • method: HTTP 方法（"GET", "POST", "PUT", "PATCH", "DELETE"）
  • endpoint: Discord API 端点（如 "guilds/{guild.id}/roles"）
  • payload: 可选的 JSON 对象，用于请求体

常见问题解答

• 建议将服务器、频道和用户 ID 以及一些示例保存在项目知识中，以避免重复提醒模型
• Unicode 表情符号可以直接包含在消息内容中
• 频道类型：0 = 文本，2 = 语音，4 = 分类，13 = 舞台
• 角色颜色为十进制格式（非十六进制）
• 大多数修改端点使用 PATCH 方法
• 空负载应为 {} 而不是 null

使用教程

使用依赖

1. 设置 Discord 机器人：
2. 在 Discord Developer Portal 创建新应用
3. 创建机器人并复制令牌
4. 启用所需的特权意图：
   • MESSAGE CONTENT INTENT
   • PRESENCE INTENT
   • SERVER MEMBERS INTENT
5. 使用 OAuth2 URL Generator 邀请机器人到您的服务器

安装教程

通过 Smithery 安装

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

手动安装

# 克隆仓库
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"
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。