🚀 MCP 中继服务器

MCP 中继服务器允许 Claude 向 Discord 频道发送消息和提示，并接收来自该频道的响应，为信息交互提供了便利。

🚀 快速开始

✨ 主要特性

• 支持 Claude 与 Discord 频道之间的消息交互，可发送消息和提示并接收响应。
• 提供 send-message 工具，支持多种消息类型和操作按钮配置。

📦 安装指南

1. 创建 Discord 应用程序和机器人

1. 访问 Discord 开发者控制台。
2. 点击“新建应用程序”，并为其命名。
3. 转到左侧边栏的“机器人”部分。
4. 在机器人的令牌部分下，点击“重置令牌”，并复制新的令牌。

   ⚠️ 重要提示

   请务必妥善保管此令牌，切勿公开分享。

5. 在“特权网关意图”下启用以下选项：
   • 消息内容意图
   • 服务器成员意图
   • 用户在线状态意图

2. 邀请机器人到你的服务器

1. 转到左侧边栏的“OAuth2”部分。
2. 选择“URL 生成器”。
3. 在“作用域”下，选择：
   • bot
   • applications.commands
4. 在“机器人权限”下，选择：
   • 发送消息
   • 嵌入链接
   • 阅读消息历史记录
5. 复制生成的 URL，并在浏览器中打开。
6. 选择你的服务器，并授权机器人。

3. 获取频道 ID

1. 在 Discord 中，启用开发者模式：
   • 转到用户设置 > 应用设置 > 高级。
   • 打开“开发者模式”。
2. 右键点击你想要使用的频道。
3. 点击“复制频道 ID”。

4. 配置 MCP 设置

服务器需要在你的 MCP 设置文件中进行配置。在你的配置文件中添加以下内容：

{
    "mcpServers": {
        "discord-relay": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/MCP Relay/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_bot_token_here",
                "DISCORD_CHANNEL_ID": "your_channel_id_here"
            }
        }
    }
}

替换说明：

• /ABSOLUTE/PATH/TO/MCP Relay：请替换为你的 MCP 中继项目的实际路径。
• your_bot_token_here：请替换为你自己的 Discord 机器人令牌。
• your_channel_id_here：请替换为你自己的 Discord 频道 ID。

⚠️ 重要提示

请确保在配置中使用绝对路径。

💻 使用示例

基础用法

服务器提供了一个名为 send-message 的工具，接受以下参数：

{
  type: 'prompt' | 'notification',  // 消息类型
  title: string,                    // 消息标题
  content: string,                  // 消息内容
  actions?: Array<{                 // 可选操作按钮
    label: string,                  // 按钮标签
    value: string                   // 点击时返回的值
  }>,
  timeout?: number                  // 可选超时时间（以毫秒为单位）
}

高级用法

通知消息

通知是简单的不需要回复的消息，示例如下：

{
  "type": "notification",
  "title": "你好",
  "content": "这是一个通知"
}

提示消息

提示是等待回复的消息，示例如下：

{
  "type": "prompt",
  "title": "问题",
  "content": "你想要继续吗？",
  "actions": [
    { "label": "是", "value": "yes" },
    { "label": "否", "value": "no" }
  ],
  "timeout": 60000  // 可选：1 分钟超时
}

⚠️ 重要提示

• 提示可以通过点击操作按钮或发送文本消息来进行回复。
• 每个提示仅接受一个响应。
• 如果设置了超时，提示将在超时后失败。
• 通知不会等待回复，会立即返回。