Discord MCP Server

Discord MCP Server

site icon
2025.01.21 58
TypeScriptDiscord 集成消息自动化交流协作
Discord MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,它使大型语言模型(LLMs)能够通过 Discord API 与 Discord 频道进行交互,包括发送和读取消息。该服务允许像 Claude 这样的 LLMs 直接与 Discord 频道互动,同时保持用户控制和安全性。
View on GitHub

Overview

基本能力

产品定位

Discord MCP Server 是一个连接大型语言模型(LLMs)和 Discord 平台的中间件服务,使 LLMs 能够安全地与 Discord 频道进行交互。

核心功能

  • 向 Discord 频道发送消息
  • 从频道读取最近的消息
  • 自动发现服务器和频道
  • 支持频道名称和 ID
  • 适当的错误处理和验证

适用场景

  • 自动化 Discord 消息发送
  • 监控和读取 Discord 频道消息
  • 集成 LLMs 到 Discord 社区管理
  • 开发 Discord 相关的自动化工具

工具列表

  1. send-message:向指定的 Discord 频道发送消息
  2. 参数:server(可选,服务器名称或 ID)、channel(频道名称或 ID)、message(要发送的消息内容)
  3. read-messages:从指定的 Discord 频道读取最近的消息
  4. 参数:server(可选)、channellimit(可选,要获取的消息数量,默认50,最大100)

常见问题解答

  • 需要确保 Discord 机器人有正确的权限
  • 所有消息发送操作需要用户明确批准
  • 环境变量需要妥善保护
  • 令牌不应提交到版本控制
  • 频道访问仅限于机器人被授予访问权限的频道

使用教程

使用依赖

  • Node.js 16.x 或更高版本
  • Discord 机器人令牌
  • 机器人必须被邀请到您的服务器并具有以下权限:
  • 读取消息/查看频道
  • 发送消息
  • 读取消息历史

安装教程

  1. 克隆仓库:
git clone https://github.com/yourusername/discordmcp.git
cd discordmcp
  1. 安装依赖:
npm install
  1. 在根目录创建 .env 文件并添加 Discord 机器人令牌:
DISCORD_TOKEN=your_discord_bot_token_here
  1. 构建服务器:
npm run build

调试方式

  1. 开发模式启动服务器:
npm run dev
  1. 使用 MCP Inspector 测试服务器:
npx @modelcontextprotocol/inspector node build/index.js

许可证

该项目遵循 MIT 开源许可条款。