mcp格拉迪亚
MCP服务器 格拉迪亚 音频转录和智能。使LLM能够通过Gladia的API转录、分析和翻译音频/视频内容。
获取API密钥
- 注册地址: App.ladia.io
- 导航到 API密钥部分
- 为新帐户自动创建默认的API密钥
格拉迪亚提供 每月10小时免费音频转录。不需要信用卡。
安装
npm install mcp-gladia或者直接运行:
npx mcp-gladia配置
将您的Gladia API密钥设置为环境变量:
export GLADIA_API_KEY=your-api-key-here克劳德桌面
增添 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"gladia": {
"command": "npx",
"args": ["mcp-gladia"],
"env": {
"GLADIA_API_KEY": "your-api-key-here"
}
}
}
}克劳德代码
claude mcp add gladia -- npx mcp-gladia然后在环境中设置API密钥或 .env 文件。
其他MCP客户端
任何兼容MCP的客户端都可以通过stdio传输使用此服务器。将命令设置为 npx mcp-gladia 并提供 GLADIA_API_KEY 作为环境变量。
工具
上传文件
将音频/视频文件上传到Gladia进行转录。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| filePath | string | Yes | 音频/视频文件的路径 |
支持的格式:mp3、wav、m4a、mp4、mov、avi、flac(最大1GB)。
转录
提交一个音频文件进行转录,并自动轮询,直到完成。支持所有Gladia音频智能功能。如果发生超时(5分钟),则返回完成的结果或作业ID。
| 参数 | 类型 | 必填 | 说明 | ||
|---|---|---|---|---|---|
| audioUrl | 字符串 | 是 | 来自upload_file的URL | ||
| 语言 | 字符串 | 否 | 语言代码(例如。 en, fr).看 支持的语言 | ||
| detectLanguage | boolean | 否 | 自动检测语言(默认值:true) | ||
| 日记化 | 布尔值 | 否 | 启用说话者识别 | ||
| diarizationConfig | 对象 | 否 | { numberOfSpeakers?, minSpeakers?, maxSpeakers? } | ||
| 字幕 | 布尔值 | 否 | 生成字幕文件 | ||
| 副标题配置 | 对象 | 否 | { formats: ["srt", "vtt"] } | ||
| customVocabulary | string\[\] | 否 | 自定义单词以提高识别率 | ||
| summary | boolean | 否 | 启用转录摘要 | ||
| summarization配置 | 对象 | 否 | `{ type: "general" \ | "concise" \ | "bullet_points" }` |
| 感伤分析 | 布尔值 | 否 | 启用情绪/情感分析 | ||
| namedEntityRecognition | boolean | 否 | 启用实体检测 | ||
| chaputization | boolean | 否 | 启用带时间戳的章节检测 | ||
| 翻译 | 布尔值 | 否 | 启用翻译 | ||
| translationConfig | 对象 | 否 | `{ targetLanguages: ["fr", "es"], model?: "base" \ | "enhanced" }` | |
| audioTolm | boolean | 否 | 启用自定义LLM分析 | ||
| audioToLlConfig | 对象 | 否 | { prompts: ["your question about the audio"] } |
get_transcription_status
检查转录作业的状态(对于超时的长时间运行的作业很有用)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| jobId | 字符串(UUID) | 是 | 来自先前转录请求的作业ID |
list_transcription_jobs
使用可选筛选列出过去的转录作业。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| offset | number | No | 分页偏移 |
| limit | number | No | 最大结果数(默认值:20) |
| status | string | 否 | 筛选器: queued, processing, done, error |
| afterDate | string | No | 按创建日期筛选(ISO 8601) |
| beforeDate | string | No | 按创建日期筛选(ISO 8601) |
| kind | string | 否 | 筛选器: pre-recorded, live |
delete_transcription_job
删除转录作业及其数据。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| jobId | 字符串(UUID) | 是 | 要删除的作业ID |
音频智能功能
所有智能功能均作为选项启用 transcribe 该工具由Gladia在服务器端处理。
摘要
以三种格式之一生成转录摘要:
| 类型 | 描述 |
|---|---|
general | 平衡、全面的摘要(默认) |
concise | 要点简述 |
bullet_points | 要点清单 |
{ "summarization": true, "summarizationConfig": { "type": "bullet_points" } }情绪与情感分析
检测记录中每个句子的情绪和情感,并在启用日记时注明说话者的归属。
情绪: positive, negative, neutral, mixed, unknown
情绪: adoration, anger, joy, fear, surprise, sadness, neutral,以及更多
{ "sentimentAnalysis": true }命名实体识别
检测并分类音频中提到的实体。支持跨多个类别的50多种实体类型:
| 类别 | 实体类型 |
|---|---|
| PII | 姓名、电子邮件、电话号码、社会安全号码 |
| 地点 | 城市、国家、地址 |
| 医疗(PHI) | 状况、药物、伤害 |
| 金融 | 银行账户、信用卡 |
| 人口统计 | 年龄、性别、职业 |
| 时间 | 日期、时间 |
支持GDPR、HIPAA和CPRA合规工作流程。
{ "namedEntityRecognition": true }章节化
自动将音频分段为逻辑章节。每章包括:
- 摘要 --本章内容概述
- 标题 --简短标题
- 要点 --一条底线
- 关键词 --提到的关键术语
- 时间戳 --开始和结束时间
{ "chapterization": true }翻译
将转录翻译成一种或多种目标语言。
| 型号 | 描述 |
|---|---|
base | 快速翻译,涵盖大多数用例 |
enhanced | 更高的质量,更适合复杂的内容 |
{ "translation": true, "translationConfig": { "targetLanguages": ["fr", "es"], "model": "enhanced" } }LLM音频(自定义提示)
直接对音频内容运行自定义分析提示。无需使用单独的法学硕士学位发布流程成绩单。
{
"audioToLlm": true,
"audioToLlmConfig": {
"prompts": [
"Extract the key decisions made in this meeting",
"What are the action items and who is responsible?"
]
}
}说话人分割
识别并分离音频中的扬声器。输出包括每个话语上的说话者标签。
{
"diarization": true,
"diarizationConfig": { "minSpeakers": 2, "maxSpeakers": 5 }
}支持的语言
支持100多种语言进行转录。使用语言代码 language 参数或设置 detectLanguage: true (默认)用于自动检测。
|语言|代码||语言|代码||语言|代码| |----------|------|-|----------|------|-|----------|------| |南非荷兰语| af ||夏威夷语| haw ||波斯语| fa | |阿尔巴尼亚语| sq ||希伯来语| he ||波兰语| pl | |阿姆哈拉语| am ||印地语| hi ||葡萄牙语| pt | |阿拉伯语| ar ||匈牙利语| hu ||旁遮普语| pa | |亚美尼亚语| hy ||冰岛语| is ||罗马尼亚语| ro | |阿萨姆语| as ||印尼语| id ||俄语| ru | |阿塞拜疆语| az ||意大利语| it ||梵语| sa | |巴什基尔| ba ||日语| ja ||塞尔维亚语| sr | |巴斯克语| eu ||爪哇语| jw ||绍纳| sn | |白俄罗斯语| be ||卡纳达语| kn ||信德语| sd | |孟加拉语| bn ||哈萨克语| kk ||僧伽罗语| si | |波斯尼亚语| bs ||高棉语| km ||斯洛伐克语| sk | |布列塔尼| br ||韩语| ko ||斯洛文尼亚语| sl | |保加利亚语| bg ||老挝| lo ||索马里语| so | |加泰罗尼亚语| ca ||拉丁语| la ||西班牙语| es | |中文| zh ||拉脱维亚语| lv ||巽他语| su | |克罗地亚语| hr ||林加拉语| ln ||斯瓦希里语| sw | |捷克语| cs ||立陶宛语| lt ||瑞典语| sv | |丹麦语| da ||卢森堡语| lb ||塔加拉族语| tl | |荷兰语| nl ||马其顿语| mk ||塔吉克语| tg | |英语| en ||马达加斯加语| mg ||泰米尔语| ta | |爱沙尼亚语| et ||马来语| ms ||鞑靼语| tt | |法罗语| fo ||马拉雅拉姆语| ml ||泰卢固语| te | |芬兰语| fi ||马耳他语| mt ||泰语| th | |法语| fr ||毛利人| mi Tibetan bo | |加利西亚语| gl ||马拉地语| mr ||土耳其语| tr | |格鲁吉亚语| ka ||蒙古语| mn ||土库曼语| tk | |德语| de ||缅甸| my ||乌克兰语| uk | |希腊语| el ||尼泊尔语| ne ||乌尔都语| ur | |古吉拉特语| gu ||挪威语| no ||乌兹别克语| uz | |海地克里奥尔语| ht ||尼诺斯克| nn ||越南语| vi | |豪萨| ha ||奥克语| oc ||威尔士语| cy | |普什图语| ps 沃洛夫。 wo | |意第绪语| yi | |约鲁巴语| yo |
使用示例
基础转录
Upload my-recording.mp3 and transcribe it与多位演讲者会面
Transcribe this meeting recording with diarization enabled, expecting 3-5 speakers.
Generate a bullet-point summary and extract action items using audio-to-LLM.多语言内容分析
Transcribe this podcast, detect the language, translate to English and French,
and run sentiment analysis on the conversation.合规性和实体检测
Transcribe this customer call with named entity recognition to identify
any PII mentioned (names, emails, phone numbers).自定义音频分析
Transcribe this earnings call and use audio-to-LLM with these prompts:
- "What are the key financial metrics mentioned?"
- "What is the company's guidance for next quarter?"
- "Summarize the Q&A section"故障排除
| 问题 | 解决方案 |
|---|---|
GLADIA_API_KEY is required | 设置 GLADIA_API_KEY 环境变量 |
Unsupported file format | 使用mp3、wav、m4a、mp4、mov、avi或flac |
File too large | 文件必须小于1GB |
| 转录超时 | 使用 get_transcription_status 使用返回的作业ID |
| 翻译失败 | 确保 translationConfig.targetLanguages 提供 |
Invalid uuid | 作业ID必须是有效的UUID(来自transcript或list_transcription_jobs) |
发展
git clone https://github.com/gladiaio/mcp-gladia.git
cd mcp-gladia
npm install
npm run build
npm run dev需要Node.js 18+。
链接
许可证
麻省理工学院
