@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操作 | 对象？ | 建议调用的下一个工具 |
示例工作流程
- 提交文件进行分析：
> “分析/Users/me/Downloads/interview.mp4上的视频”
助理打来电话 echosaw_analyze_media 与路径和 mediaType: "video"，返回a mediaId.
- 检查处理状态：
> “这种分析的现状如何？”
助理打来电话 echosaw_check_job_status 随着 mediaId.
- 检索结果：
> “显示结果”
完成后，助理会打电话 echosaw_get_analysis_results 检索完整的情报报告，包括成绩单、安全分析、内容见解和元数据。
- 下载源媒体：
> “给我那个视频的下载链接”
助理打来电话 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