Deepgram异步MCP服务器
支持webhook中继的Deepcram Async Speech-to-Text API远程MCP服务器。异步转录长音频和视频文件-非常适合营销人员转录长达一小时的视频和播客，而不会出现超时问题。
为什么选择此服务器？
问题：Claude MCP Connect有10秒的超时时间，但转录长视频需要几分钟的时间。
解决方案：带轮询的真正异步处理：
- 提交转录作业（立即返回request_id）
- 后台Deepgram进程
- 结果存储在webhook中继（Cloudflare Worker）中
- 每30秒轮询一次，直到准备就绪
- 获取所有功能的完整成绩单
建筑
Your AI → MCP Server → Deepgram API (async)
↓
Webhook Relay (Cloudflare Worker + KV Storage)
↑
MCP Server ← Poll for results特性
两个MCP工具
- 提交转录作业 -发送音频/视频URL进行异步转录
- ✅ 处理1小时以上的视频，不超时 - ✅ 说话者日记（检测不同的说话者） - ✅ 智能格式和标点符号 - ✅ 情感分析 - ✅ 主题检测 - ✅ 实体提取（名称、地点、品牌） - ✅ 摘要 - ✅ 多语言支持 - ✅ 多种AI模型（Nova-3、Nova-2、Whisper）
- check_job_status -准备就绪后检索转录结果
- ✅ 轮询作业完成情况 - ✅ 获取所有请求功能的完整转录 - ✅ 自动回退到Deegram Management API
- test_deepgram_connection -验证设置是否正常工作
先决条件
- Deegram API密钥 (在这里买一个)
- Webhook中继 （Cloudflare Worker）- 必修的！
- 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
- 将此仓库推送到GitHub
- 首选 史密瑟里
- 连接您的GitHub存储库
- 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密钥:
- 首选 Deepgram控制台
- 引导到 API密钥
- 点击 创建新的API密钥
- 选择 成员 角色（或管理员/所有者）
- 复制密钥并在配置中使用
看 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中继”
- 验证Cloudflare Worker是否已部署：
wrangler deployments list - 手动测试：
curl https://your-worker.workers.dev/health - 检查配置中的webhook URL是否正确
“未找到成绩单”
- 作业可能仍在处理中-请等待30秒，然后重试
- 检查request_id是否正确
- 在webhook中继中，转录将在7天后过期
“403禁止”
- API密钥缺少权限-必须是成员角色或更高级别
- 看 API_任务.md 详细指南
“提交转录作业失败”
- 验证音频URL是否可公开访问
- 检查Deepgram帐户是否有信用
- 确保支持文件格式（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（视频渲染）
- 任何具有异步处理+回调的服务
许可证
麻省理工学院
贡献
欢迎拉取请求！请确保：
- TypeScript编译时没有错误
- Smithery建造成功
- 文档已更新
更新日志
v2.0.0（当前）
- ✅ 使用webhook中继实现真正的异步处理
- ✅ Cloudflare Worker用于转录存储
- ✅ 长视频投票支持
- ✅ 处理1小时以上的内容而不超时
v1.0.0
- 具有基本异步支持的初始版本