Skip to main content
Glama
Sign In
deenesjakoruzh
@vidalytics/mcp

@vidalytics/mcp

Official
by vidalytics
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

@vidalytics/mcp

npm version CI license

一条命令即可完成设置，通过 Model Context Protocol 将您的 AI 编程助手连接到 Vidalytics 视频分析数据。

适用于 Claude（CLI 和 Desktop）、Windsurf、Cursor 以及任何其他兼容 MCP 的客户端。

设置

npx @vidalytics/mcp install

就这样。安装程序会检测您已安装的 AI 客户端，让您选择要配置哪些客户端，并自动完成配置。重启客户端——首次使用时将打开浏览器窗口进行 OAuth 授权。

Related MCP server: YouTube MCP

Cursor

Add Vidalytics to Cursor

或通过安装程序：

npx @vidalytics/mcp install --client cursor

或手动操作 — 将以下内容添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "vidalytics": {
      "url": "https://api.vidalytics.com/public/v1/mcp"
    }
  }
}

重启 Cursor。首次使用时，浏览器窗口将打开，通过您的 Vidalytics 账户进行 OAuth 授权——无需设置 API 密钥或环境变量。

功能说明

  • 通过检查配置文件、应用目录、$PATH 中的二进制文件和应用包（例如 macOS 上的 /Applications）来检测已安装的 MCP 客户端（Claude CLI、Claude Desktop、Windsurf、Cursor）

  • 显示交互式清单（已检测到的客户端默认选中），以便您精确配置所需的客户端——或使用 --client 以非交互方式选择

  • 将 Vidalytics 作为 MCP 服务器添加到每个所选客户端的配置中

  • 写入后验证：配置有效且 MCP 服务器可访问

  • 非交互式终端（CI）和任何显式选择标志（--client、--all、--yes）将跳过清单并按预期方式运行

可用工具

连接成功后，您的 AI 助手将获得以下工具：

工具

描述

set_user_context

必须在调用任何其他工具之前调用，以启用分析功能

list_videos

分页列出视频

get_video

获取视频详情

get_video_by_embed_guid

通过嵌入 GUID 查找视频

update_video

更新视频的标题或文件夹

get_video_embed

获取嵌入代码和配置

get_video_settings

获取播放设置（自动播放、控件等）

get_video_thumbnail

获取缩略图图片 URL

get_video_stats

观看次数、播放率、观看时长、转化率

get_video_dropoff

按百分比查看观众留存率

get_video_percentage_watched

到达每个时间点的观众百分比

get_video_live_metrics

实时在线观看人数和观看率

get_video_ctas

获取视频的 CTA

get_video_pause_screens

获取视频的暂停画面

get_videos_stats_batch

一次获取最多 30 个视频的统计数据

get_videos_timeline

最多 5 个视频的时间线统计数据

list_folders

列出视频文件夹

list_settings_templates

列出设置模板

get_api_usage

获取当前 API 使用量和配额

list_connections

列出已连接到您账户的应用

revoke_connection

断开应用或您自己的连接

upload_video_from_url

从远程 URL 上传视频

get_video_upload_url

获取用于本地文件上传的签名 URL

validate_upload

完成直接视频上传

publish_video

发布视频待处理的草稿设置

duplicate_video

复制视频并发布副本

create_folder

创建视频文件夹，可选择嵌套在其他文件夹下

apply_settings_template

将可复用的播放器设置模板应用于视频

create_video_cta

在视频上创建行动号召（CTA）

update_video_cta

更新视频上现有的行动号召（CTA）

set_video_thumbnail_from_url

从公共图片 URL 设置视频缩略图

set_video_thumbnail_from_frame

从视频的某一帧设置缩略图

delete_video_thumbnail

移除自定义缩略图并恢复默认

选项

npx @vidalytics/mcp install [flags]

  --client <names>   Configure only these clients, comma-separated
                     (claude-cli, claude-desktop, windsurf, cursor)
  --all              Configure all known clients, even if not detected
  --config <path>    Also configure a custom config file (repeatable)
  --force            Re-apply even if already configured
  --yes              Skip prompts (configure detected clients)

在交互式终端中不带任何标志运行，即可获得要配置的客户端清单（已检测到的客户端默认选中；使用空格键切换，回车键确认）。--client cursor,windsurf 可以非交互方式完成相同的选择。

--config 标志可重复使用以指定多个文件。目标文件必须遵循 Claude Desktop、Cursor 和 Windsurf 使用的 { "mcpServers": {} } 格式——适用于 Zed 或带有 MCP 插件的 VS Code 等不受支持的客户端。

故障排除

遇到授权问题，或需要重新认证？ 重置 mcp-remote 缓存在您主目录中的凭据，然后重启客户端：

操作系统

命令

macOS / Linux

rm -rf ~/.mcp-auth

Windows（CMD）

rd /s /q "%USERPROFILE%\.mcp-auth"

Windows（PowerShell）

Remove-Item -Recurse -Force "$HOME\.mcp-auth"

MCP Registry

此服务器已作为 com.vidalytics/mcp 发布到官方 MCP Registry。它是一个远程（streamable-http）服务器，因此支持注册表的 MCP 客户端可以直接连接到：

https://api.vidalytics.com/public/v1/mcp

无需 API 密钥或环境变量——首次使用时通过 OAuth 完成授权。

系统要求

  • Node.js 18+

  • 一个 Vidalytics 账户

许可证

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers