Gladia MCP

<div class="title-block" style="text-align: center;" align="center">

</div>

<p align="center"> 官方 Gladia <a href="https://github.com/modelcontextprotocol">模型上下文协议 (MCP)</a> 服务器，支持与强大的语音转文本和音频智能 API 进行交互。此服务器允许 MCP 客户端（如 <a href="https://www.anthropic.com/claude">Claude Desktop</a>、<a href="https://www.cursor.so">Cursor</a>、<a href="https://codeium.com/windsurf">Windsurf</a>、<a href="https://github.com/openai/openai-agents-python">OpenAI Agents</a> 等）转录音频、分析语音、翻译内容等。 </p>

功能

• 带有说话人区分的音频转录
• 实时语音转文本
• 音频智能功能：
  • 翻译
  • 摘要
  • 命名实体识别
  • 情感分析
  • 内容审核
  • 章节划分
  • 音频到 LLM 集成
• 带有 FastAPI 的异步 API
• 易于使用的 CLI 界面
• 可配置的日志记录
• 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，包含以下内容：

{
  "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：

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

可选功能

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

贡献

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

1. 克隆存储库：

git clone https://github.com/gladia/gladia-mcp
cd gladia-mcp

2. 创建一个虚拟环境并安装依赖项 使用 uv:

uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

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

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

4. 运行测试以确保一切正常：

./scripts/test.sh
# 或使用选项
./scripts/test.sh --verbose --fail-fast

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

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

API 端点

健康检查

GET /health

转录音频

POST /transcribe

参数：

• file: 音频文件 (multipart/form-data)
• diarization: 启用说话人区分 (boolean, optional)
• language: 语言代码 (string, optional)

使用 curl 的示例：

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%\Claude\logs\mcp-server-gladia.log
• macOS: ~/Library/Logs/Claude/mcp-server-gladia.log

MCP Gladia: spawn uvx ENOENT

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

which uvx

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

开发

运行测试

pytest

代码风格

该项目遵循 PEP 8 风格指南。 使用 flake8 进行 linting：

flake8 gladia_mcp

许可证

MIT 许可证