媒体智能分析服务

Echosaw MCP服务器将AI助手(如Claude Desktop、Cursor等)与Echosaw的媒体智能分析平台连接,支持提交媒体文件进行分析、检查状态、获取智能报告和下载源文件。

  • by Orange-Sky-Software-Inc
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Orange-Sky-Software-Inc/echosaw-mcp-server

使用说明

@echosaw/mcp服务器

Echosaw MCP服务器——用于媒体智能的AI助手集成。

Echosaw MCP服务器将AI助手(Claude Desktop、Cursor和其他MCP兼容客户端)连接到Echosaw的媒体智能平台。提交媒体进行分析、检查状态、检索情报报告和下载源文件——所有这些都可以在您的人工智能驱动的开发环境中完成。

先决条件

  • Node.js 18+ (支持的最低版本 @modelcontextprotocol/sdk)
  • Echosaw API密钥 -您的API密钥在订阅开发人员、增长、专业或代理计划后通过电子邮件发送给您。

安装

npm install -g @echosaw/mcp-server

环境变量

变量 必填 默认 描述
ECHOSAW_API_KEY 是 - 您的Echosaw API密钥
ECHOSAW_API_URL 没有 https://api.echosaw.com API基本URL(gamma/staging覆盖)

客户端配置

克劳德桌面版

将以下内容添加到您的Claude Desktop配置文件中(claude_desktop_config.json):

{
  "mcpServers": {
    "echosaw": {
      "command": "echosaw-mcp",
      "env": {
        "ECHOSAW_API_KEY": "your-api-key"
      }
    }
  }
}

光标

添加到光标MCP设置中:

{
  "mcpServers": {
    "echosaw": {
      "command": "echosaw-mcp",
      "env": {
        "ECHOSAW_API_KEY": "your-api-key"
      }
    }
  }
}

可用工具

工具 说明
echosaw_analyze_media 将音频、视频或图像文件上传到Echosaw进行异步媒体分析。返回用于跟踪处理和检索结果的作业ID。
echosaw_analyze_media_url 将可公开访问或授权的媒体URL提交给Echosaw进行异步分析,而无需直接上传文件。返回用于跟踪处理和检索结果的作业ID。
echosaw_check_job_status 检索Echosaw分析作业的当前处理状态,包括作业是否已排队、正在处理、已完成或失败。
echosaw_get_analysis_results 检索Echosaw为已完成作业生成的结构化分析结果,包括摘要、成绩单、检测到的实体、事件和其他情报输出。支持可选 section 参数(summary, transcript, safety, insights, metadata, downloads, all)以减小响应大小。
echosaw_download_media 为与已完成的分析作业关联的源媒体文件生成预签名的下载URL。URL的有效期为1小时。

响应格式

所有工具都返回标准化的JSON响应:

字段 类型 描述
success boolean 操作是否成功
tool string 产生此响应的工具
responseVersion string 响应架构版本(当前为“1.0”)
数据 对象 工具特定结果数据
消息 字符串? 人类可读摘要
错误 字符串? 错误描述(当成功为false时)
next操作 对象? 建议调用的下一个工具

示例工作流程

  1. 提交文件进行分析:

    “分析/Users/me/Downloads/interview.mp4上的视频”

    助理打来电话 echosaw_analyze_media 与路径和 mediaType: "video",返回a mediaId.

  2. 检查处理状态:

    “这种分析的现状如何?”

    助理打来电话 echosaw_check_job_status 随着 mediaId.

  3. 检索结果:

    “显示结果”

    完成后,助理会打电话 echosaw_get_analysis_results 检索完整的情报报告,包括成绩单、安全分析、内容见解和元数据。

  4. 下载源媒体:

    “给我那个视频的下载链接”

    助理打来电话 echosaw_download_media 获取有效期为1小时的预签名URL。

发展

# Clone and build
cd lib/mcp-server
npm install
npm run build

# Run directly
ECHOSAW_API_KEY=your-key node dist/bin/echosaw-mcp.js