Restream MCP Server

限制MCP服务器

模型上下文协议（MCP）服务器，提供与Restream API交互的工具。此服务器使Claude和其他MCP客户端能够通过自然语言管理流媒体频道、控制流和访问分析。

特性

• 用户配置文件管理：获取经过身份验证的用户信息
• 渠道管理：列出、查看、启用/禁用流媒体频道
• 流控制：启动、停止和更新流设置
• 分析：访问流媒体分析和性能数据
• OAuth身份验证：使用客户端凭据安全访问API

可用工具

1. get_user_profile

获取经过身份验证的用户配置文件信息，包括电子邮件、显示名称和帐户详细信息。

2. list_channels

列出所有连接的流媒体频道/平台（YouTube、Twitch、Facebook等）及其连接状态。

3. get_channel

通过ID获取特定频道的详细信息。

参数：

• channelId （string，必填）：要检索的通道的ID

4. update_channel_status

启用或禁用特定流媒体频道。

参数：

• channelId （string，必填）：要更新的通道的ID
• enabled （boolean，必填）：是启用（true）还是禁用（false）通道

5. get_current_stream

获取有关当前/活动流的信息，包括标题、状态、RTMP URL和观众计数。

6. update_stream_settings

更新当前流的设置，如标题、描述或隐私设置。

参数：

• title （字符串，可选）：流标题
• description （字符串，可选）：流描述
• privacy （string，可选）：流隐私设置（公共、私有、未列出）

7. get_stream_analytics

获取流的分析和统计数据，包括观众计数、参与度指标和性能数据。

参数：

• streamId （string，可选）：可选流ID，用于获取特定流的分析

8. start_stream

使用可选设置启动新流。

参数：

• title （字符串，可选）：流标题
• description （字符串，可选）：流描述
• privacy （string，可选）：流隐私设置（公共、私有、未列出）

9. stop_stream

停止当前活动流。

安装

先决条件

• Node.js 18或更高版本
• npm或纱线
• 重新整理API凭据（客户端ID和客户端机密）

选项1：从npm安装（推荐）

npm install -g @shaktech786/restream-mcp-server

或者在项目中本地安装：

npm install @shaktech786/restream-mcp-server

选项2：从源代码安装

1. 克隆此存储库：

git clone https://github.com/shaktech786/restream-mcp-server.git
cd restream-mcp-server

1. 安装依赖项：

npm install

1. 构建服务器：

npm run build

配置

通过环境变量或在Claude Desktop配置中配置Restream API凭据：

环境变量（.env文件）：

RESTREAM_CLIENT_ID=your_client_id_here
RESTREAM_CLIENT_SECRET=your_client_secret_here
RESTREAM_API_BASE_URL=https://api.restream.io/v2

获取Restream API凭据

1. 首选 Restream开发人员门户
2. 创建新应用程序或使用现有应用程序
3. 复制您的客户端ID和客户端密码
4. 将它们添加到您的 .env 文件

使用Claude Desktop

要将此MCP服务器与Claude Desktop一起使用，请将其添加到您的Claude Desktop配置文件中：

视窗: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

如果通过npm安装：

{
  "mcpServers": {
    "restream": {
      "command": "npx",
      "args": ["-y", "@shaktech786/restream-mcp-server"],
      "env": {
        "RESTREAM_CLIENT_ID": "your_client_id_here",
        "RESTREAM_CLIENT_SECRET": "your_client_secret_here",
        "RESTREAM_API_BASE_URL": "https://api.restream.io/v2"
      }
    }
  }
}

如果从源代码安装：

{
  "mcpServers": {
    "restream": {
      "command": "node",
      "args": ["/absolute/path/to/restream-mcp-server/dist/index.js"],
      "env": {
        "RESTREAM_CLIENT_ID": "your_client_id_here",
        "RESTREAM_CLIENT_SECRET": "your_client_secret_here",
        "RESTREAM_API_BASE_URL": "https://api.restream.io/v2"
      }
    }
  }
}

保存配置后重新启动Claude Desktop。

发展

以开发模式运行

npm run dev

这将监视更改并自动重建。

测试服务器

您可以使用MCP检查器在本地测试服务器：

npx @modelcontextprotocol/inspector node dist/index.js

API端点参考

此服务器使用Restream API v2。主要终点包括：

• POST /oauth/token -身份验证
• GET /user/profile -获取用户资料
• GET /user/channels -列出频道
• GET /user/channels/:id -获取频道详细信息
• PATCH /user/channels/:id -更新频道
• GET /user/stream -获取当前流
• PATCH /user/stream -更新流设置
• POST /user/stream/start -启动流
• POST /user/stream/stop -停止流
• GET /user/analytics -获取分析

有关API完整文档，请访问 Restream开发人员门户.

Claude使用示例

配置后，您可以要求Claude：

• “列出我连接的所有流媒体频道”
• “获取我当前的流信息”
• “将我的流标题更新为‘实时编码会话’”
• “启用我的YouTube频道”
• “显示我的流媒体分析”
• “以“游戏之夜”为标题开始新的流”

故障排除

身份验证错误

如果遇到身份验证错误：

1. 验证您的客户端ID和客户端密码是否正确
2. 确保凭据具有必要的权限
3. 检查API基础URL是否正确

连接问题

如果服务器无法连接：

1. 确保所有依赖项都已安装(npm install)
2. 重建服务器(npm run build)
3. 检查Node.js版本是否为18或更高
4. 验证Claude Desktop配置中的路径是否正确

安全说明

• 永远不要承诺你的 .env 文件到版本控制
• 保护您的客户端ID和客户端密码的安全
• 定期轮换您的API证书
• 这 .gitignore 文件已配置为排除 .env

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交问题或拉取请求。

支持

对于MCP服务器的问题，请在GitHub上提交问题。

有关Restream API的问题，请访问 Restream开发人员门户.