MCP Relay Server

🚀 MCP 中继服务器

MCP 中继服务器可让 Claude 向 Discord 频道发送消息和提示，并且能接收频道的回复，极大地增强了信息交互的便利性。

🚀 快速开始

✨ 主要特性

• 支持 Claude 与 Discord 频道之间的消息收发，实现高效的信息交互。
• 提供 send-message 工具，支持多种消息类型和操作按钮配置。

📦 安装指南

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

1. 访问 Discord 开发者门户网站。
2. 点击 “新建应用程序” 并为其命名。
3. 转到左侧边栏的 “Bot” 部分。
4. 在机器人的令牌部分，点击 “重置令牌” 并复制新的令牌。
   • ⚠️ 重要提示：请务必安全保管此令牌！不要公开分享。
5. 在 “Privileged Gateway Intents”（特权网关意图）中启用：
   • 消息内容意图
   • 服务器成员意图
   • 上线意图

2. 邀请机器人加入您的服务器

1. 转到左侧边栏的 “OAuth2” 部分。
2. 选择 “URL 生成器”。
3. 在 “范围” 下，选择：
   • bot
   • applications.commands
4. 在 “Bot Permissions”（机器人权限）下，选择：
   • 发送消息
   • 嵌入链接
   • 阅读消息历史记录
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 // 示例：60秒超时
}

🔧 技术细节

• 消息内容最长可支持 32,768 字节。
• 支持的文件类型包括但不限于：PDF、DOCX、PPTX、ZIP、PNG、JPG 等。