Deepgram Async MCP Server

Deepgram异步MCP服务器

支持webhook中继的Deepcram Async Speech-to-Text API远程MCP服务器。异步转录长音频和视频文件-非常适合营销人员转录长达一小时的视频和播客，而不会出现超时问题。

为什么选择此服务器？

问题：Claude MCP Connect有10秒的超时时间，但转录长视频需要几分钟的时间。

解决方案：带轮询的真正异步处理：

1. 提交转录作业（立即返回request_id）
2. 后台Deepgram进程
3. 结果存储在webhook中继（Cloudflare Worker）中
4. 每30秒轮询一次，直到准备就绪
5. 获取所有功能的完整成绩单

建筑

Your AI → MCP Server → Deepgram API (async)
                          ↓
                    Webhook Relay (Cloudflare Worker + KV Storage)
                          ↑
         MCP Server ← Poll for results

特性

两个MCP工具

1. 提交转录作业 -发送音频/视频URL进行异步转录

- ✅ 处理1小时以上的视频，不超时 - ✅ 说话者日记（检测不同的说话者） - ✅ 智能格式和标点符号 - ✅ 情感分析 - ✅ 主题检测 - ✅ 实体提取（名称、地点、品牌） - ✅ 摘要 - ✅ 多语言支持 - ✅ 多种AI模型（Nova-3、Nova-2、Whisper）

1. check_job_status -准备就绪后检索转录结果

- ✅ 轮询作业完成情况 - ✅ 获取所有请求功能的完整转录 - ✅ 自动回退到Deegram Management API

1. test_deepgram_connection -验证设置是否正常工作

先决条件

1. Deegram API密钥 (在这里买一个)
2. Webhook中继 （Cloudflare Worker）- 必修的！
3. Smithery账户 用于部署

快速开始

步骤1：部署Webhook中继

请参阅完整指南： SETUP_GUIDE.md

快速版本:

cd deepgram-webhook-relay
npm install -g wrangler
wrangler login
wrangler kv:namespace create TRANSCRIPTS
# Update wrangler.toml with KV namespace ID
wrangler deploy

你会得到一个类似的URL： https://deepgram-webhook-relay.YOUR_SUBDOMAIN.workers.dev

步骤2：将MCP服务器部署到Smithery

1. 将此仓库推送到GitHub
2. 首选 史密瑟里
3. 连接您的GitHub存储库
4. Smithery将自动部署

步骤3：配置

在Smithery中提供这些值：

{
  "deepgramApiKey": "your-deepgram-api-key",
  "webhookUrl": "https://your-worker.workers.dev/callback"
}

步骤4：在Claude中使用

系统提示:

When transcribing audio/video:
1. Use submit_transcription_job to start
2. Get the request_id from response
3. Wait 30 seconds (use sleep tool)
4. Use check_job_status with request_id
5. If "Still Processing", repeat steps 3-4
6. When "Complete", present the transcript

示例:

User: Transcribe this podcast: https://example.com/podcast.mp4

AI: I'll transcribe that for you.
[Uses submit_transcription_job]
Job submitted! Request ID: abc123
[Waits 30s]
[Uses check_job_status]
Still processing...
[Waits 30s]
[Uses check_job_status]
✅ Complete! Here's the transcript: ...

配置

必需

• deepgramApiKey：您的Deegram API密钥（必须具有 成员角色或更高级别)
• webhookUrl：您的Cloudflare Worker回调URL（例如。， https://your-worker.workers.dev/callback)

可选的

• 项目ID：您的Deepgram项目ID（如果未提供，则自动检测）

API关键要求

⚠️ 重要：您的Deegram API密钥必须具有 成员角色或更高级别.

所需权限:

• project:write -提交转录作业
• project:read -自动检测项目ID（如果提供projectId，则可选）
• usage:read -通过管理API检查作业状态

如何创建正确的API密钥:

1. 首选 Deepgram控制台
2. 引导到 API密钥
3. 点击 创建新的API密钥
4. 选择 成员 角色（或管理员/所有者）
5. 复制密钥并在配置中使用

看 API_任务.md 了解详细的故障排除。

用法示例

基础转录

Tool: submit_transcription_job
Parameters:
  url: "https://example.com/video.mp4"
  smart_format: true
  punctuate: true

营销用例（全功能）

Tool: submit_transcription_job
Parameters:
  url: "https://example.com/podcast.mp4"
  diarize: true              # Detect speakers
  smart_format: true         # Professional formatting
  punctuate: true            # Add punctuation
  paragraphs: true           # Split into paragraphs
  sentiment: true            # Analyze sentiment
  topics: true               # Detect topics
  detect_entities: true      # Extract names, brands
  summarize: true            # Generate summary
  model: "nova-3"            # Latest model

检查状态

Tool: check_job_status
Parameters:
  request_id: "abc123-def456-..."

处理时间

典型处理时间（因文件长度和复杂性而异）：

• 5分钟视频：30-60秒
• 30分钟视频：1-2分钟
• 1小时视频：2-3分钟
• 2小时播客：5-8分钟

推荐：每30秒轮询一次，以平衡响应能力和API使用情况。

故障排除

“无法访问Webhook中继”

1. 验证Cloudflare Worker是否已部署： wrangler deployments list
2. 手动测试： curl https://your-worker.workers.dev/health
3. 检查配置中的webhook URL是否正确

“未找到成绩单”

1. 作业可能仍在处理中-请等待30秒，然后重试
2. 检查request_id是否正确
3. 在webhook中继中，转录将在7天后过期

“403禁止”

1. API密钥缺少权限-必须是成员角色或更高级别
2. 看 API_任务.md 详细指南

“提交转录作业失败”

1. 验证音频URL是否可公开访问
2. 检查Deepgram帐户是否有信用
3. 确保支持文件格式（MP3、WAV、MP4等）

完整的文件

• SETUP_GUIDE.md -分步部署指南
• API_任务.md -API密钥权限和故障排除
• 部署.md -Smithery部署详细信息
• deepgram webhook中继/README.md -Webhook中继文档

项目结构

deepgram-mcp-server/          # MCP server (this directory)
├── src/
│   ├── index.ts              # Main MCP server
│   └── deepgram-client.ts    # Deepgram API client
├── package.json
├── smithery.yaml
└── README.md

deepgram-webhook-relay/       # Cloudflare Worker
├── worker.js                 # Webhook relay logic
├── wrangler.toml            # Cloudflare config
└── README.md

成本

Deepgram（按需付费）

• 诺瓦-3：0.0043美元/分钟
• 1小时视频=约0.26美元
• 定价详情

Cloudflare（免费层）

• 100000次请求/天
• 1 GB KV存储
• 对于大多数用例来说，这已经足够了

Smithery（自由层）

• MCP服务器的慷慨免费层
• 定价详情

支持

• 设置问题：参见 SETUP_GUIDE.md
• API权限：参见 API_任务.md
• Deepgram: https://developers.deepgram.com
• 史密瑟里: https://smithery.ai/docs

相关项目

此MCP服务器可与其他异步工具配合使用：

• Klap（视频编辑）
• Rendi（视频渲染）
• 任何具有异步处理+回调的服务

许可证

麻省理工学院

贡献

欢迎拉取请求！请确保：

1. TypeScript编译时没有错误
2. Smithery建造成功
3. 文档已更新

更新日志

v2.0.0（当前）

• ✅ 使用webhook中继实现真正的异步处理
• ✅ Cloudflare Worker用于转录存储
• ✅ 长视频投票支持
• ✅ 处理1小时以上的内容而不超时

v1.0.0

• 具有基本异步支持的初始版本