Kinescope MCP

@显像管/mcp

用于Kinescope API的MCP服务器-模型上下文协议服务器，提供对Kinescope视频平台API的访问。

安装

npm install -g @kinescope/mcp

或者直接与npx一起使用：

npx -y @kinescope/mcp@latest --api-key YOUR_API_KEY

用法

带光标

✅ 默认值：仅动态工具（3个工具）

默认情况下，该包使用 仅限动态工具（3个工具），这使您完全低于Cursor建议的限制 80工具这在保持性能的同时提供了最大的灵活性。

要使用所有静态工具（126个工具），请添加 --include-all-tools:

默认配置（3个动态工具）-推荐

{
  "mcpServers": {
    "kinescope": {
      "command": "npx",
      "args": ["-y", "@kinescope/mcp@latest", "--client=cursor"],
      "env": {
        "KINESCOPE_API_KEY": "your_api_key_here"
      }
    }
  }
}

仅限API视频（约26个静态工具）

{
  "mcpServers": {
    "kinescope": {
      "command": "npx",
      "args": ["-y", "@kinescope/mcp@latest", "--client=cursor", "--include-all-tools", "--resource", "video.*"],
      "env": {
        "KINESCOPE_API_KEY": "your_api_key_here"
      }
    }
  }
}

所有静态工具（126个工具）-小心使用

{
  "mcpServers": {
    "kinescope": {
      "command": "npx",
      "args": ["-y", "@kinescope/mcp@latest", "--client=cursor", "--include-all-tools"],
      "env": {
        "KINESCOPE_API_KEY": "your_api_key_here"
      }
    }
  }
}

按类别统计的工具数量：

• video.* -约26个工具
• data.* -~3个工具
• live_streams.* -~18个工具
• real_time.* -约10个工具
• system.* -约69个工具

看 工具-极限解决方案.md 详细的解决方案。

使用Claude桌面版

添加到您的Claude Desktop MCP配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "kinescope": {
      "command": "npx",
      "args": ["-y", "@kinescope/mcp@latest", "--client=claude"],
      "env": {
        "KINESCOPE_API_KEY": "your_api_key_here"
      }
    }
  }
}

命令行选项

npx -y @kinescope/mcp@latest [options]

Options:
  --api-key               Kinescope API key (or use KINESCOPE_API_KEY env var)
  --base-url              Base URL for API (optional)
  --transport      Transport type (default: stdio)
  --port               Port for HTTP transport (default: 3000)
  --client               MCP client type: cursor, claude, claude-code, openai-agents, infer (default: infer)
  --include-dynamic-tools      Include dynamic tools (default: true)
  --include-all-tools          Include all static tools (default: false)
  --resource 
         Filter by resource category (e.g., video.*, data.*, live_streams.*)
  --help                       Show help

资源过滤

按类别筛选工具：

# Only Video API tools
npx -y @kinescope/mcp@latest --resource video.*

# Video and Analytics tools
npx -y @kinescope/mcp@latest --resource video.* --resource data.*

# Multiple categories
npx -y @kinescope/mcp@latest --resource video.*,data.*,live_streams.*

可用资源类别：

• video.* -视频API（视频、海报、字幕、注释）
• data.* -分析和指标API
• live_streams.* -直播API
• real_time.* -实时/语音API（视频通话、房间）
• system.* -系统API（项目、标签、Webhook、播放器等）

特性

• ✅ 126+API端点 涵盖所有Kinescope API功能
• ✅ 客户端兼容性 -Cursor、Claude、Claude Code、OpenAI代理的自动适配
• ✅ 资源过滤 -按类别筛选工具（视频、数据、直播等）
• ✅ 动态工具 -用于发现和调用任何端点的通用工具
• ✅ HTTP传输 -通过HTTP进行远程访问（可选）
• ✅ 分析支持 -视频性能指标、国家分析、参与度数据

API覆盖范围

视频API

• 列出和管理视频
• 视频操作（复制、剪切、拼接）
• 海报、字幕、注释
• 视频元数据和状态

分析API

• 自定义分组分析
• 带时间线的概述指标
• 按国家、设备、视频分列的性能
• 参与度指标

直播API

• 现场活动管理
• 限流器配置
• QoS度量
• 事件调度

系统API

• 项目和文件夹
• 标签和webhooks
• 玩家配置
• 主持人和播放列表
• 访问令牌和文件请求

例子

获取视频性能指标

// Using the MCP tool
kinescope_overview_overview_overview({
  from: '2024-12-01',
  to: '2024-12-14',
  group_time: 'day'
})

列出带过滤器的视频

kinescope_videos_videos_list({
  page: '1',
  per_page: '10',
  order: 'created_at.desc',
  status: ['done']
})

按国家获取分析

kinescope_analytics_custom({
  from: '2024-11-01',
  to: '2024-12-01',
  group: 'month',
  group_entities: 'country_code',
  fields: 'country_code,view,unique_view,watch_time',
  order: 'view.desc'
})

许可证

麻省理工学院

Lobehub

](https://lobehub.com/mcp/kinescope-kinescope-mcp)

链接

• Kinescope API文档
• 模型上下文协议
• 本地安装指南（俄语） -本地安装详细指南