Discord Claude Bridge MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • 该仓库实现了一个 MCP 服务器，用于通过 MCP 协议向 Claude Code CLI 发送文件和消息。它通过一个 SQLite 消息队列在 Discord Bot 与 Claude Bridge 之间传递请求与响应，从而实现“Discord 端发送文件/消息，Claude Code 端处理后返回”的工作流。

• 主要功能点

  • MCP 工具：提供 send_file_to_discord、send_multiple_files_to_discord 两个工具，用于将本地文件发送到 Discord 的私聊或频道中（支持嵌入卡片格式）。
  • 基于消息队列的解耦：通过 shared/message_queue.py 实现消息、文件请求等队列化处理，前后端通过队列进行通信与状态更新。
  • 支持多传输协议：MCP 服务器可以通过标准输入输出（stdio）或 HTTP 传输，便于本地开发与调试。
  • 与现有 Discord Bot/Broadcast 系统整合：服务器侧实现工具调用入口，实际的 Discord 交付由已存在的 Discord Bot 程序完成。

• 安装步骤

  • 克隆仓库并进入项目目录。
  • 安装依赖（如果需要）：pip install -r requirements.txt。
  • 确保本地已配置好 Claude Code CLI、Discord Bot、以及数据库/配置文件（config.yaml、claude 配置等）。
  • 运行 MCP 服务器（示例：使用 stdio 传输）
    • python mcp_server/server.py --transport stdio
  • 如需通过 MCP 客户端使用 HTTP 传输，请按需配置 host/port。

• 服务器配置（MCP 客户端用于连接 MCP 服务器的配置信息，以下为示例 JSON，需替换为实际环境信息） { "server name": "discord-bridge", "command": "python", "args": [ "mcp_server/server.py", "--transport", "stdio" ], "env": { "PYTHONPATH": "<项目根目录>" } } 说明：

  • server name：在 MCP 客户端中标识的服务器名称
  • command/args：启动服务器的命令和参数，与实际环境一致即可
  • env：必要时设置的环境变量，如 PYTHONPATH 指向项目根目录 MCP 客户端不需要本仓库的额外实现，以上配置信息用于建立与 MCP 服务器的连接

• 基本使用方法

  • 启动后，MCP 客户端可以向服务器调用工具，例如调用 send_file_to_discord 发送单个文件，或调用 send_multiple_files_to_discord 发送多个文件。
  • 传输完成后，服务器将返回 JSON 形式的响应，包含成功状态、消息、以及可能的结果标识（如 message_id）。
  • 服务器通过现有的 Discord Bot 进程完成实际的 Discord 调用，确保 Bot 正在运行且配置正确。