HelloWorld
登录
g

gladiaio

speech-processingaudio-processinglanguage-translation

14 查看 · 2026-07-07 更新

Gladia MCP

PyPI Tests

官方Gladia 模型上下文协议 (MCP) 服务器，支持与强大的语音转文字和音频智能API进行交互。该服务器允许像Claude Desktop、Cursor、Windsurf、OpenAI Agents等MCP客户端进行音频转录、语音分析、内容翻译等功能。

功能

  • 带有说话人分割的音频转录
  • 实时语音转文字
  • 音频智能功能：
    • 翻译
    • 摘要
    • 命名实体识别
    • 情感分析
    • 内容审核
    • 分章节
    • 音频到大语言模型（LLM）集成
  • 使用FastAPI的异步API
  • 易于使用的命令行界面
  • 可配置的日志记录
  • CORS支持
  • 健康检查端点

Claude Desktop快速入门

  1. 从Gladia获取您的API密钥。提供免费层级。
  2. 安装uv（Python包管理器），使用curl -LsSf https://astral.sh/uv/install.sh | sh安装或参见uv仓库以获取更多安装方法。
  3. 转到Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，包含以下内容：

json { "mcpServers": { "Gladia": { "command": "uvx", "args": ["gladia-mcp"], "env": { "GLADIA_API_KEY": "<在此插入您的API密钥>" } } } }

如果您使用的是Windows系统，则需要在Claude Desktop中启用“开发者模式”才能使用MCP服务器。点击左上角的汉堡菜单中的“帮助”，然后选择“启用开发者模式”。

其他MCP客户端

对于其他客户端如Cursor和Windsurf，请运行：

  1. pip install gladia-mcp
  2. python -m gladia_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print 获取配置。将其粘贴到由您的MCP客户端指定的适当配置目录中。

示例用法

尝试向Claude提问：

  • “转录这个音频文件并识别不同的说话人”
  • “将这段录音转换为文本并翻译成西班牙语”
  • “分析这段讲话的情感和情绪”
  • “从这个长音频文件中提取关键主题并创建章节”
  • “转录这段对话并总结主要观点”

可选功能

您可以在claude_desktop_config.json中添加GLADIA_MCP_BASE_PATH环境变量，以指定MCP服务器应查找和输出文件的基本路径。

贡献

如果您想贡献代码或从源码运行：

  1. 克隆仓库： bash git clone https://github.com/gladia/gladia-mcp cd gladia-mcp

  2. 创建虚拟环境并安装依赖项使用uv： bash uv venv source .venv/bin/activate uv pip install -e ".[dev]"

  3. 将.env.example复制到.env并添加您的Gladia API密钥： bash cp .env.example .env

编辑.env并添加您的API密钥

  1. 运行测试以确保一切正常： bash ./scripts/test.sh

或者带选项运行

./scripts/test.sh --verbose --fail-fast

  1. 在Claude Desktop中安装服务器：mcp install gladia_mcp/server.py

  2. 使用MCP Inspector本地调试和测试：mcp dev gladia_mcp/server.py

API端点

健康检查

GET /health

转录音频

POST /transcribe

参数：

  • file: 音频文件 (multipart/form-data)- diarization: 启用说话人日记化（布尔值，可选）
  • language: 语言代码（字符串，可选）

使用 curl 的示例： bash curl -X POST "http://localhost:8000/transcribe" -H "accept: application/json" -H "Content-Type: multipart/form-data" -F "file=@audio.wav" -F "diarization=true"

故障排除

运行 Claude Desktop 时的日志位置如下：

  • Windows: %APPDATA%Claudelogsmcp-server-gladia.log
  • macOS: ~/Library/Logs/Claude/mcp-server-gladia.log

MCP Gladia: spawn uvx ENOENT

如果您遇到错误 "MCP Gladia: spawn uvx ENOENT"，请通过在终端中运行以下命令来确认其绝对路径： bash which uvx

一旦您获得了绝对路径（例如 /usr/local/bin/uvx），请更新您的配置以使用该路径（例如 "command": "/usr/local/bin/uvx"）。这确保引用了正确的可执行文件。

开发

运行测试

bash pytest

代码风格

项目遵循 PEP 8 风格指南。使用 flake8 进行代码检查： bash flake8 gladia_mcp

许可证

MIT 许可证

服务配置

[{'mcpServers': {'Gladia': {'args': ['gladia-mcp'], 'command': 'uvx', 'env': {'GLADIA_API_KEY': '<insert-your-api-key-here>'}}}}]

来源