discord-mcp

通过 CLI 添加（默认为本地项目范围；添加 -s user 可应用于所有项目）：

claude mcp add discord -e DISCORD_TOKEN="your-bot-token" -- npx -y @qungtai/discord-mcp

或在 ~/.claude.json 中手动配置：

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@qungtai/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token"
      }
    }
  }
}

编辑适用于你操作系统的配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json（非官方构建版本）

添加服务配置块：

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@qungtai/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token"
      }
    }
  }
}

通过 CLI 添加：

codex mcp add discord --env DISCORD_TOKEN="your-bot-token" -- npx -y @qungtai/discord-mcp

或添加到 ~/.codex/config.toml：

[mcp_servers.discord]
command = "npx"
args = ["-y", "@qungtai/discord-mcp"]

[mcp_servers.discord.env]
DISCORD_TOKEN = "your-bot-token"

添加到 .cursor/mcp.json，或在 Cursor Settings > MCP 中配置：

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@qungtai/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token"
      }
    }
  }
}

在 .vscode/mcp.json 中配置，并为机器人令牌设置输入变量：

{
  "servers": {
    "discord": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@qungtai/discord-mcp"],
      "env": {
        "DISCORD_TOKEN": "${input:discordToken}"
      }
    }
  },
  "inputs": [
    {
      "id": "discordToken",
      "type": "promptString",
      "description": "Discord Bot Token",
      "password": true
    }
  ]
}

运行检查器：

npx @modelcontextprotocol/inspector -- npx -y @qungtai/discord-mcp

连接前，在检查器环境面板中设置 DISCORD_TOKEN。

使用 Docker 运行服务：

docker run -i --rm -e DISCORD_TOKEN="your-bot-token" -v /path/to/downloads:/home/node/Downloads/discord-mcp -v /path/to/uploads:/uploads ghcr.io/qungtai/discord-mcp:latest

使用文件工具时，请使用 -v host_path:container_path 挂载主机目录，以便在容器外访问上传和下载的文件。传递给工具的上传路径必须是容器路径。在 Linux 绑定挂载中，如果容器用户权限导致无法写入已挂载的主机目录，请传递 --user "$(id -u):$(id -g)" -e DISCORD_MCP_DOWNLOAD_DIR=/home/node/Downloads/discord-mcp。

在 MCP 客户端中配置（在 Linux 上使用自定义 --user 时，还需将 -e DISCORD_MCP_DOWNLOAD_DIR=/home/node/Downloads/discord-mcp 添加到 args）：

{
  "mcpServers": {
    "discord": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DISCORD_TOKEN",
        "-v",
        "/path/to/downloads:/home/node/Downloads/discord-mcp",
        "-v",
        "/path/to/uploads:/uploads",
        "ghcr.io/qungtai/discord-mcp:latest"
      ],
      "env": {
        "DISCORD_TOKEN": "your-bot-token"
      }
    }
  }
}

• discord_get_my_user：获取当前机器人用户
• discord_get_user：根据 ID 获取用户
• discord_leave_guild：离开一个服务器（需要批准）
• discord_list_my_connections：列出机器人用户的连接
• discord_list_my_guilds：列出机器人加入的服务器。使用 after=next_after 翻页。在 DISCORD_MCP_ALLOWED_GUILDS 下无法翻页；一次调用会返回所有允许的服务器。
• discord_update_my_user：更新当前机器人的用户名、头像或横幅（需要批准）

• discord_bulk_delete_messages：一次性从频道中删除多条消息（2-100 条，且消息发布时间不超过 14 天）（需要批准）
• discord_create_pin：在频道中置顶一条消息
• discord_crosspost_message：将公告频道中的消息转发（发布）到关注该频道的频道
• discord_delete_message：从频道中删除一条消息（需要批准）
• discord_delete_pin：取消置顶频道中的一条消息
• discord_download_attachment：将消息附件下载到 DISCORD_MCP_DOWNLOAD_DIR
• discord_edit_message：编辑消息内容、嵌入内容和附件元数据，或添加附件
• discord_end_poll：立即结束消息中的投票
• discord_get_message：获取一条消息
• discord_list_messages：按时间从新到旧列出消息。使用 before=next_before 翻页
• discord_list_pins：列出频道中的置顶消息
• discord_list_poll_answer_voters：获取投选某个特定投票选项的用户列表
• discord_search_guild_messages：搜索服务器中的消息。使用 offset=next_offset 翻页
• discord_send_message：发送一条消息
• discord_trigger_typing_indicator：在频道中触发正在输入指示器

• discord_add_my_message_reaction：以当前用户身份为消息添加回应
• discord_delete_all_message_reactions：删除消息上的所有回应（需要批准）
• discord_delete_all_message_reactions_by_emoji：删除消息上指定表情符号的所有回应（需要批准）
• discord_delete_my_message_reaction：删除当前用户对消息的回应
• discord_delete_user_message_reaction：删除另一位用户对消息的回应（需要批准）
• discord_list_message_reactions_by_emoji：获取使用指定表情符号进行回应的用户列表

• discord_bulk_update_guild_channels：修改服务器中一组频道的位置（需要审批）
• discord_create_dm：与用户开启私信频道
• discord_create_guild_channel：在服务器中创建新频道（需要审批）
• discord_delete_channel：删除频道，或关闭私信（需要审批）
• discord_delete_channel_permission_overwrite：删除频道的权限覆盖设置（需要审批）
• discord_follow_channel：关注公告频道，以便将消息发送到目标频道
• discord_get_channel：根据 ID 获取频道
• discord_get_member_permissions：获取计算后的服务器或频道成员权限
• discord_get_role_permissions：获取计算后的服务器或频道角色权限
• discord_list_guild_channels：列出服务器中的频道
• discord_set_channel_permission_overwrite：设置或更新频道的权限覆盖设置（需要审批）
• discord_update_channel：更新频道设置（需要审批）
• discord_update_voice_channel_status：设置或清除语音频道状态（需要审批）

• discord_create_webhook：在频道中创建新的 Webhook
• discord_delete_webhook：永久删除 Webhook（需要审批）
• discord_delete_webhook_message：删除 Webhook 之前发送的消息（需要审批）
• discord_edit_webhook_message：编辑 Webhook 之前发送的消息（需要审批）
• discord_execute_webhook：执行 Webhook 以发送消息（需要审批）
• discord_get_webhook：根据 ID 获取 Webhook
• discord_get_webhook_message：获取 Webhook 之前发送的消息
• discord_list_channel_webhooks：列出频道中的 Webhook
• discord_list_guild_webhooks：列出服务器中的 Webhook
• discord_update_webhook：更新 Webhook 的名称、头像，或将其移至其他频道（需要审批）

• discord_add_guild_member_role：为服务器成员添加角色（需审批）
• discord_delete_guild_member：将成员从服务器中移除（踢出）（需审批）
• discord_delete_guild_member_role：移除服务器成员的角色（需审批）
• discord_get_guild_member：根据用户 ID 获取服务器成员
• discord_list_guild_join_requests：列出服务器的加入申请，可按申请状态筛选
• discord_list_guild_members：列出服务器成员。需要 Server Members 特权 Gateway 意图（GUILD_MEMBERS）。使用 after=next_after 翻页
• discord_preview_prune_guild：获取清理操作将移除的成员数量
• discord_prune_guild：开始清理操作，从服务器中移除不活跃成员（需审批）
• discord_review_guild_join_request：批准或拒绝服务器加入申请。仅当 action 为 REJECTED 时使用 rejection_reason（需审批）
• discord_search_guild_members：搜索用户名或昵称以查询内容开头的服务器成员。需要 Server Members 特权 Gateway 意图（GUILD_MEMBERS）
• discord_update_guild_member：更新服务器成员的属性。Discord 不允许在此处编辑机器人自身；discord_update_my_guild_member 可更改机器人自身的昵称。channel_id 用于将成员移至语音频道；设为 null 则断开连接（需审批）
• discord_update_my_guild_member：更新当前机器人的昵称或其在服务器中的成员资料

• discord_bulk_update_guild_roles：修改服务器中一组角色对象的位置（需审批）
• discord_create_guild_role：创建新的服务器角色（需审批）
• discord_delete_guild_role：删除服务器角色（需审批）
• discord_get_guild_role：获取服务器角色
• discord_get_guild_role_member_counts：获取服务器中各角色的成员数量
• discord_list_guild_roles：列出服务器中的角色
• discord_update_guild_role：更新服务器角色（需审批）

• discord_count_guild_scheduled_event_users：获取服务器计划活动及其例外情况的用户人数
• discord_create_guild_scheduled_event：为服务器创建计划活动
• discord_create_guild_scheduled_event_exception：为定期服务器计划活动创建例外情况
• discord_delete_guild_scheduled_event：删除服务器计划活动（需审批）
• discord_delete_guild_scheduled_event_exception：删除定期服务器计划活动的例外情况（需审批）
• discord_get_guild_scheduled_event：按 ID 获取服务器计划活动
• discord_list_guild_scheduled_event_exception_users：获取订阅服务器计划活动某个重复例外情况的用户列表，按用户 ID 升序排列。使用 after=next_after 分页
• discord_list_guild_scheduled_event_users：获取订阅服务器计划活动的用户列表，按用户 ID 升序排列。使用 after=next_after 分页
• discord_list_guild_scheduled_events：列出服务器的计划活动
• discord_update_guild_scheduled_event：修改服务器计划活动（需审批）
• discord_update_guild_scheduled_event_exception：修改定期服务器计划活动的例外情况（需审批）

• discord_add_invite_target_user：将目标用户添加到现有邀请中（需审批）
• discord_bulk_add_invite_target_users：将多个目标用户添加到现有邀请中（需审批）
• discord_bulk_delete_invite_target_users：从现有邀请中移除多个目标用户（需审批）
• discord_create_channel_invite：为频道创建新邀请（需审批）
• discord_delete_invite：按代码删除邀请（需审批）
• discord_delete_invite_target_user：从现有邀请中移除目标用户（需审批）
• discord_get_invite：按代码获取邀请。在允许列表限制下，设置 target_message_id 时必须同时设置 target_channel_id，以便检查消息。
• discord_get_invite_target_users_job_status：获取邀请的目标用户任务状态
• discord_list_channel_invites：获取频道的所有有效邀请
• discord_list_guild_invites：获取服务器的所有有效邀请
• discord_list_invite_target_users：获取邀请的目标用户。响应以 CSV 文本形式返回在 csv 字段中。
• discord_set_invite_target_users：使用 CSV 文件设置邀请的目标用户。（需审批）