Dacast

Dacast MCP 服务

此仓库提供一个 Model Context Protocol (MCP) 服务，将 Dacast 视频平台 API 封装为一组结构化 MCP 工具。它让兼容 MCP 的客户端（例如 Claude Desktop）能够通过自然语言管理 Dacast 资源——频道、播放列表、图片、同步直播目标等。

---

功能

• 基于 StdIO 的 MCP 服务

  • 通过标准输入/输出使用 Model Context Protocol。
  • 专为由 MCP 客户端进程启动并作为子进程持续运行而设计。

• Dacast API 集成

  • 频道管理：创建、列出、获取、更新。
  • 播放列表管理：创建、列出、获取、更新、设置播放列表内容。
  • 图片管理：缩略图和启动图片。
  • 同步直播目标管理：创建、获取、删除。

---

安装

前提条件

• Go：Go 1.24+（较早版本可能可用，但不作保证）。
• Dacast 账户和 API 密钥：执行需要身份验证的操作时必需。

MCP 客户端配置

基于 JSON 的 MCP 客户端配置可能如下所示：

{
  "mcpServers": {
    "dacast": {
      "command": "go",
      "args": ["run", "github.com/Dacast-Inc/mcp-server-public@latest"],
      "env": {
        "DACAST_API_KEY": "DACAST API KEY HERE"
      }
    }
  }
}

架构概览

高层设计

此服务是一个 Go 单一二进制文件，它会：

1. 启动 MCP stdio 服务。
2. 注册一组按 Dacast 领域分组的工具（频道、播放列表、图片、同步直播）。
3. 对于每个传入的 MCP call_tool 请求：
   • 绑定并验证工具参数。
   • 使用内部 ApiClient，向相关的 Dacast REST 端点构造 HTTP 请求。
   • 使用适当的身份验证标头，将请求转发给 Dacast。
   • 将 JSON 响应（以及可选的转换后结构化形式）返回给 MCP 客户端。

主要软件包：

• main.go – 用于初始化 MCP 服务并注册工具的入口点。
• pkg/apiclient/ – 对 Dacast REST API 的简易 HTTP 客户端封装。
• pkg/tools/ – 按领域分组的工具实现：
  • channel/ – 频道相关操作。
  • playlist/ – 播放列表相关操作。
  • images/ – 缩略图和启动图片操作。
  • simulcast/ – 同步直播目标操作。
• pkg/tools/toolscommon/ – 用于构建工具的共享类型、处理程序和实用工具。

工具 → Dacast API 映射

pkg/tools/ 下的每个工具都对应一个或多个 Dacast API 端点。

• 频道（pkg/tools/channel/）

  • create_channel.go – 创建新频道。
  • get_channel.go – 获取频道详情。
  • update_channel.go – 更新现有频道。
  • list_channel.go – 列出所有频道或筛选后的频道。

• 播放列表（pkg/tools/playlist/）

  • create_playlist.go – 创建新播放列表。
  • get_playlist.go – 获取播放列表详情。
  • update_playlist.go – 更新现有播放列表。
  • list_playlist.go – 列出播放列表。
  • set_playlist_content.go – 设置或更新播放列表内容。

• 图片（pkg/tools/images/）

  • thumbnail.go – 管理频道/资源缩略图。
  • splash.go – 管理启动图片。

• 同步直播（pkg/tools/simulcast/）

  • create_simulcast_destination.go – 创建同步直播目标。
  • get_simulcast_destination.go – 获取同步直播目标。
  • delete_simulcast_destination.go – 删除同步直播目标。

---

许可证

此项目遵循本仓库 LICENSE 文件中所述的条款。请查阅该文件以了解完整内容。