Wowza Video MCP Server Hosted

Wowza视频MCP服务器（测试版）

此MCP服务器通过模型上下文协议（MCP）向AI助手提供Wowza视频流功能。

Wowza视频API文档: https://developer.wowza.com/docs/wowza-video/api/video/current/overview/

使用WOWZA视频MCP服务器

托管服务器设置

先决条件：

• Wowza视频API密钥（必需）
• Wowza视频播放器ID（必填）

跳过本地设置，直接使用托管的MCP服务器：

1. 无需安装 -服务器已在运行且可用
2. 使用此URL: https://wowza-mcp.app.avaintellect.com/mcp/
3. 配置IDE 使用托管URL和您的Wowza凭据（请参阅下面的IDE配置部分）

_注意：您仍然需要有效的Wowza Video API凭据才能使用托管服务器。_

IDE配置示例

本节提供了使用无状态Wowza Video MCP服务器方法的不同IDE的配置示例，其中Wowza Videoneneneba API密钥和播放器ID通过HTTP头从客户端IDE发送。

服务器URL

• 托管MCP服务器: https://wowza-mcp.app.avaintellect.com/mcp/

_替换 MCP_SERVER_URL 在下面的示例中，使用上面的URL。_

1.风浪

配置文件： ~/.codeium/windsurf/mcp_config.json （Linux/macOS）或 %USERPROFILE%\.codeium\windsurf\mcp_config.json （Windows）

{
  "mcpServers": {
    "wowza-mcp-http": {
      "url": "https://wowza-mcp.app.avaintellect.com/mcp/",
      "headers": {
        "X-Wowza-Api-Key": "",
        "X-Wowza-Player-Id": "
",
        "X-Wowza-Flags": "read-only"
      }
    }
  }
}

2.VS代码

配置文件： 创建 .mcp.json 在您的工作区根目录中或添加到VS代码设置中

{
  "servers": {
    "wowza-mcp-http": {
        "url": "https://wowza-mcp.app.avaintellect.com/mcp/",
        "headers": {
          "X-Wowza-Api-Key": "",
          "X-Wowza-Player-Id": "
",
          "X-Wowza-Flags": "read-only"
        }
      }
  }
}

3.光标

配置文件： 创建 .mcp.json 在您的工作区根目录中

{
  "mcpServers": {
    "wowza-mcp-http": {
      "url": "https://wowza-mcp.app.avaintellect.com/mcp/",
      "headers": {
        "X-Wowza-Api-Key": "",
        "X-Wowza-Player-Id": "
",
        "X-Wowza-Flags": "read-only"
      }
    }
  }
}

4.克劳德桌面

Claude Desktop不直接支持JSON配置中具有自定义标头的HTTP MCP服务器。相反，使用 克劳德代码 （CLI）具有完整的HTTP MCP服务器支持：

安装Claude代码命令行界面 : https://docs.anthropic.com/en/docs/claude-code/setup

# Add the Wowza MCP server with headers
claude mcp add --transport http wowza-mcp-http https://wowza-mcp.app.avaintellect.com/mcp/ \
  --header "X-Wowza-Api-Key: " \
  --header "X-Wowza-Player-Id: 
" \
  --header "X-Wowza-Flags: read-only"

_注：更换 ` 使用您的实际Wowza Video API密钥和 使用您的Wowza视频播放器ID进行自定义 X-Wowza-Flags` 根据您的需求。_

使用X-Wowza-Flags进行工具筛选和分类

注： 默认情况下，所有操作都使用 read-only 安全标志。这确保了除非另有明确配置，否则无法执行任何破坏性操作。

Wowza Video MCP服务器提供了对哪些工具暴露在IDE中的精细控制，允许您仅定制所需功能的访问。这是通过 X-Wowza-Flags 头球

如何应用过滤器

要应用筛选器，您可以包括 X-Wowza-Flags 如上面的示例所示，在IDE中的MCP服务器配置中使用header。

主要类别（标志）及其子类别（工具）

旗帜系统与 或逻辑 用于类别标志和 过滤逻辑 对于访问修饰符：

类别标志 （结合OR逻辑）：

• 如果您指定 resource,usage，您可以从这两个类别中获得所有工具
• 子类别标志，如 vod 如果是多余的 resource 已指定
• 仅当您想从更广泛的类别中缩小范围时，才使用特定的子类别

访问修改器标志 （筛选现有选择）：

• read-only：从所选类别中筛选出所有写入/破坏性操作
• write：仅显示所选类别中的写入操作

只读标志行为

这 read-only 旗帜起着 过滤器 在您选择的类别上，而不是类别本身：

• "resource,read-only" =所有资源工具，但仅限于读取操作
• "usage,analytics,read-only" =所有使用和分析工具，但仅限于读取操作
• "read-only" =所有工具，但仅限于读取操作

这意味着 read-only 永远不要减少你的工具类别，它只会删除写入/破坏性功能。

标志组合示例：

您可以使用逗号分隔来组合多个标志：

类别或逻辑（您可以从所有指定类别中获得所有工具）：

"X-Wowza-Flags": "resource"           // All resource tools (live, vod, transcoder, etc.)
"X-Wowza-Flags": "resource,usage"     // All resource AND usage tools combined
"X-Wowza-Flags": "analytics,usage"    // All analytics AND usage tools combined
"X-Wowza-Flags": "resource,vod"       // Same as just "resource" (vod is redundant)

作为筛选器的只读（从所选类别中删除写入操作）：

"X-Wowza-Flags": "resource,read-only"     // All resource tools, but read-only
"X-Wowza-Flags": "usage,analytics,read-only" // All usage AND analytics tools, but read-only
"X-Wowza-Flags": "read-only"              // All tools, but read-only

高效的标志使用：

// ✅ Efficient - top-level categories
"X-Wowza-Flags": "resource,usage"

// ❌ Redundant - vod is already included in resource
"X-Wowza-Flags": "resource,vod,usage"

// ✅ Specific - only if you want just vod tools
"X-Wowza-Flags": "vod"

只读查询示例

下面是不会更新、添加或删除任何内容的只读查询的实际示例。 这 read-only 当没有指定标志时，默认情况下会自动应用标志，确保安全操作。每个示例都包括用于最佳工具过滤的推荐标志。

注： 有时MCP客户端对它可以显示的工具数量有限制。因此，建议使用特定的标志来缩小工具的范围。如果没有提供标志，系统默认为 read-only 安全模式。

使用监控查询

完整使用仪表板：

"X-Wowza-Flags": "usage"

*查询：* “请给我一份过去30天的完整使用情况概述，包括实时流、转码器和流目标。”

转码器使用报告：

"X-Wowza-Flags": "usage"

*查询：* “生成一份过去30天内我帐户中所有转码器的使用情况报告，其中包含出口数据和计费信息。”

分析仪表板查询

体验质量分析：

"X-Wowza-Flags": "analytics"

*查询：* “获取过去30天的全面体验质量指标，包括回绝次数、视频开始时间分析以及我最近直播流的性能监控。”

资源状态查询

基础设施概述：

"X-Wowza-Flags": "resource"

*查询：* “提供我的流媒体基础设施的全面概述，包括直播流、转码器和实时流。”

直播流管理：

"X-Wowza-Flags": "resource"

*查询：* “显示我所有直播流的当前状态，包括它们的状态和配置。”

VOD（视频点播）查询

VOD库管理：

"X-Wowza-Flags": "vod"

*查询：* “显示最近20个VOD视频，包括其状态、持续时间和发布详细信息。”

VOD分析仪表板：

"X-Wowza-Flags": "vod,analytics"

*查询：* “获取过去30天我的VOD内容的观看分析，包括流行度指标。”

VOD质量分析：

"X-Wowza-Flags": "vod,analytics"

*查询：* “分析20个最受欢迎的VOD视频的视频开始时间和过去30天的拒绝指标。”

多类别查询示例

完整的流媒体仪表板：

"X-Wowza-Flags": "usage,analytics"

*查询：* “创建一个完整的仪表板，显示我所有流媒体资源过去30天的使用统计数据和质量指标。”

资源+使用情况监控：

"X-Wowza-Flags": "resource,usage"

*查询：* “显示我的流媒体资源及其相关的使用模式和过去30天的消费数据。”