使用说明

项目简介

Entent 是一个开源平台,旨在使大型语言模型 (LLM) 能够通过模型上下文协议 (MCP) 访问和交互实时数据 API。此组件是 Entent 平台下的 Discord MCP 服务器,专门为 LLM 提供访问 Discord 数据的能力。

主要功能点

  • 检索 Discord 消息: LLM 可以使用提供的工具,从指定的 Discord 频道获取消息内容。
  • MCP 标准协议: 采用模型上下文协议 (MCP) 与 LLM 客户端进行标准化通信。
  • Discord 集成: 通过 Discord Bot 集成 Discord 服务,实现数据访问。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm 包管理器。
  2. 克隆仓库: 从 GitHub 克隆 'ententai' 仓库到本地。
  3. 进入目录: 在本地仓库中,导航到 'mcp/discord' 目录:
    cd ententai/mcp/discord
  4. 安装依赖: 在 'mcp/discord' 目录下,运行以下命令安装项目依赖:
    npm install

服务器配置

要将此 MCP 服务器与 MCP 客户端(如 Claude Desktop)配合使用,需要在客户端中配置服务器的启动命令。以下是 JSON 格式的配置信息,请复制到你的 MCP 客户端配置文件中:

{
  "server name": "discord",
  "command": "uv",
  "args": [
    "--directory",
    "/ABSOLUTE/PATH/TO/PARENT/FOLDER/discord",  // 将此路径替换为 mcp/discord 目录的绝对路径
    "run",
    "discord.js"
  ]
}

配置说明:

  • '"server name": "discord"': 为服务器指定一个名称,例如 "discord"。
  • '"command": "uv"': 指定用于启动服务器的命令。这里使用 'uv',它是一个更快的 npm 包管理器替代品。如果你的环境没有 'uv',可以替换为 'node',并相应调整 'args' 参数。
  • '"args"': 启动命令的参数列表。
    • '"--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/discord"': 指定服务器工作目录为 'mcp/discord' 目录的绝对路径。请务必将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/discord' 替换为你本地 'mcp/discord' 目录的实际绝对路径
    • '"run", "discord.js"': 指示 'uv' (或 'node') 运行 'discord.js' 文件,这是编译后的服务器入口文件。

环境变量配置: 在启动服务器之前,你需要在运行环境中配置以下环境变量。这些变量在 'mcp/discord/src/index.ts' 文件中被使用,用于 Discord Bot 的身份验证和频道配置。请参考仓库 'README.md' 文件中 "Configuration is managed through environment variables" 部分获取详细的环境变量列表和说明,并根据你的 Discord 设置进行配置。

基本使用方法

  1. 配置并启动服务器: 按照上述 "服务器配置" 和 "环境变量配置" 说明,配置你的 MCP 客户端,并启动 Discord MCP 服务器。
  2. 连接 MCP 客户端: 确保你的 MCP 客户端(如 Claude Desktop)已正确配置并连接到运行中的 Discord MCP 服务器。
  3. 使用 'get-discord-messages' 工具: 在 LLM 客户端中,你可以调用 'get-discord-messages' 工具来检索 Discord 消息。你需要指定要检索消息的频道名称(例如 'github', 'feedback', 'general',这些频道名称已在服务器端通过环境变量预先配置),还可以选择性地指定要检索的消息数量上限。

信息

分类

通信与社交