使用说明
项目简介
Discord MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它允许大型语言模型 (LLM) 应用通过 MCP 协议与 Discord 机器人进行交互。该服务器将 Discord API 的功能封装成 MCP 工具,例如获取服务器信息、发送消息等,使得 LLM 应用能够利用这些工具来扩展其能力,例如在 Discord 上执行指令、查询信息等。
主要功能点
- 服务器信息获取: 允许 LLM 应用查询 Discord 服务器的详细信息,例如服务器名称、成员数量、频道列表等。
- 消息发送: 支持 LLM 应用通过 Discord 机器人向指定频道或用户发送消息。
- 工具注册与执行: 基于 Spring AI Tool 框架,将 Discord API 功能注册为 MCP 工具,方便 LLM 客户端调用。
- Smithery 集成: 支持通过 Smithery 快速安装和部署,简化服务器配置过程。
安装步骤
- 克隆仓库
git clone https://github.com/SaseQ/discord-mcp cd discord-mcp - 构建项目
确保已安装 Maven。在项目根目录下执行:
构建成功后,会在 'target' 目录下生成 'discord-mcp-0.0.1-SNAPSHOT.jar' 文件。mvn clean package
服务器配置
MCP 客户端(例如 Claude Desktop)需要配置 MCP 服务器的启动命令才能连接。以下是针对 Discord MCP Server 的配置信息,请添加到 MCP 客户端的服务器配置中。
{ "servers": { "discord-mcp": { "command": "java", "args": [ "-jar", "/绝对路径/discord-mcp-0.0.1-SNAPSHOT.jar" // 将 "/绝对路径" 替换为 discord-mcp-0.0.1-SNAPSHOT.jar 文件的实际路径 ], "env": { "DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN" // 将 "YOUR_DISCORD_BOT_TOKEN" 替换为你的 Discord 机器人令牌 } } } }
配置参数说明:
- 'server name': 'discord-mcp' (服务器名称,可自定义)
- 'command': 'java' (启动命令,使用 Java 运行时环境)
- 'args': '["-jar", "/绝对路径/discord-mcp-0.0.1-SNAPSHOT.jar"]' (启动参数,指定 JAR 文件路径)
- 'env': '{"DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN"}' (环境变量,用于配置 Discord 机器人令牌,请前往 Discord Developer Portal 获取)
注意: 请务必将 '/绝对路径/discord-mcp-0.0.1-SNAPSHOT.jar' 替换为实际的 JAR 文件路径,并将 'YOUR_DISCORD_BOT_TOKEN' 替换为你的 Discord 机器人令牌。
基本使用方法
-
启动 Discord MCP Server。
-
在 MCP 客户端中配置并连接到 Discord MCP Server。
-
在 LLM 应用中,可以使用以下工具与 Discord 进行交互:
- 'get_server_info(guildId)': 获取指定 Discord 服务器 ID ('guildId') 的详细信息。
- 'send_message(message, channelId)': 向指定 Discord 频道 ID ('channelId') 发送消息 ('message')。
- 'send_private_message(message, userId)': 向指定 Discord 用户 ID ('userId') 发送私信 ('message')。
LLM 应用可以通过自然语言指令调用这些工具,例如:
- "获取服务器 ID 为 123456 的服务器信息" (对应 'get_server_info' 工具)
- "在频道 ID 为 789012 的频道发送消息 '你好!'" (对应 'send_message' 工具)
- "向用户 ID 为 456789 的用户发送私信 '请注意查收消息'" (对应 'send_private_message' 工具)
具体的工具调用方式和参数格式请参考 MCP 客户端和 LLM 应用的文档。
更多信息
更详细的示例和使用方法可以参考 Wiki。
信息
分类
通信与社交