Resemble AI

Resemble AI MCP Server

官方 MCP 服务，将 Resemble AI 文档作为资源和工具提供。连接到 Cursor、Claude Code 或任何兼容 MCP 的客户端，即可让你的编码助手在开发过程中访问 Resemble AI 文档。

概述

这是官方 Resemble AI MCP 服务。它实现了 Model Context Protocol（stdio 传输），将 docs/pages/ 中的文档作为可查询资源提供。该服务按主题汇总文档，并支持对所有 MDX 文件进行全文搜索。

提供的功能：

• 按主题汇总文档（13 个主题：voice-cloning、text-to-speech、agents 等）
• 对所有 MDX 文档页面进行全文搜索
• 提供 OpenAPI 3.0 规范，包含用于代码生成的精确请求/响应架构
• 直接访问页面和端点

连接后，你的编码助手便可通过编程方式查询 Resemble AI 文档。你可以通过 vibe coding 构建完整应用——助手可即时访问指南、教程和精确的 API 架构，从而准确生成代码。

快速开始

1. 克隆并安装

git clone https://github.com/resemble-ai/resemble-mcp.git
cd resemble-mcp

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

2. 配置 MCP 客户端

Cursor：添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "resemble-ai-docs": {
      "command": "/path/to/resemble-mcp/venv/bin/python",
      "args": ["/path/to/resemble-mcp/server.py"]
    }
  }
}

Claude Code / Claude Desktop：添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或操作系统对应的位置：

{
  "mcpServers": {
    "resemble-ai-docs": {
      "command": "/path/to/resemble-mcp/venv/bin/python",
      "args": ["/path/to/resemble-mcp/server.py"]
    }
  }
}

注意：请使用绝对路径。将 /path/to/resemble-mcp 替换为实际路径。

3. 重启客户端

重启 MCP 客户端以加载服务。重启后即可使用工具。

可用工具

resemble_docs_lookup

返回某个主题的汇总文档。接受主题 ID，并返回所有相关页面的拼接内容。

参数：

• topic（字符串，必填）：以下之一：voice-cloning、text-to-speech、speech-to-speech、speech-to-text、getting-started、voice-design、streaming、detect、agents、sdks、projects-clips、audio-tools、ssml

**返回值：**包含该主题所有页面的 Markdown 内容。

resemble_search

对所有文档页面进行全文搜索。返回匹配页面及其摘要片段。

参数：

• query（字符串，必填）：搜索查询
• limit（整数，可选）：结果数量上限（默认值：5）

**返回值：**匹配页面列表，包含标题、路径和内容摘要片段。

resemble_get_page

根据路径获取特定文档页面。

参数：

• path（字符串，必填）：相对于 docs/pages/ 的页面路径（例如，getting-started/quickstart）

**返回值：**页面的完整 Markdown 内容。

resemble_list_topics

列出所有可用主题 ID 及其说明。

**返回值：**Markdown 格式的主题列表。

resemble_api_endpoint

获取特定 API 端点的详细 OpenAPI 规范。返回精确的请求/响应架构、参数和类型。

参数：

• method（字符串，必填）：HTTP 方法（GET、POST、PUT、PATCH、DELETE）
• path（字符串，必填）：API 端点路径（例如，/synthesize、/voices）

**返回值：**端点规范，包含架构、参数和响应格式。

resemble_api_search

在 OpenAPI 规范中搜索与查询匹配的端点。

参数：

• query（字符串，必填）：搜索查询（例如，voice、streaming、agent）

**返回值：**匹配端点列表，包含方法、路径和摘要。

用法

配置完成后，你的编码助手（Cursor、Claude Code 等）可以直接调用这些工具。使用示例：

构建语音克隆应用：

{
  "name": "resemble_docs_lookup",
  "arguments": { "topic": "voice-cloning" }
}

搜索流式实现：

{
  "name": "resemble_search",
  "arguments": { "query": "websocket streaming", "limit": 5 }
}

获取准确的 API 架构以供实现：

{
  "name": "resemble_api_endpoint",
  "arguments": { "method": "POST", "path": "/synthesize" }
}

查找所有语音相关的 API 端点：

{
  "name": "resemble_api_search",
  "arguments": { "query": "voice" }
}

当你要求助手构建功能时，它会自动使用这些工具。例如，“为我构建一个 TTS 流式服务”会触发 resemble_docs_lookup，查询 text-to-speech 主题，也可能使用 resemble_api_endpoint 获取准确的请求架构，以确保实现准确。

项目结构

resemble-mcp/
├── server.py               # MCP server implementation
├── docs/
│   └── pages/              # MDX documentation files
│       ├── getting-started/    # Auth, quickstart, basics
│       ├── voice-generation/   # TTS, STT, S2S
│       ├── voice-creation/     # Voice cloning, recordings
│       ├── agents/             # AI agents
│       ├── detect/             # Deepfake detection
│       └── guides/             # Step-by-step tutorials
└── openapi/
    └── openapi.yml         # OpenAPI 3.0 specification

支持的 MCP 客户端

适用于任何实现了 Model Context Protocol 的客户端：

• Cursor - AI 代码编辑器
• Claude Code - Anthropic 的编码 Agent
• Claude Desktop - Anthropic 的桌面应用
• 任何其他兼容 MCP 的客户端

开发

该服务使用 stdio 传输（从 stdin 读取，向 stdout 写入），符合 MCP 规范。

# Run server directly (for testing/debugging)
python server.py

架构：

• 服务实现：server.py
• 文档源：docs/pages/（MDX 文件）
• API 规范：openapi/openapi.yml（OpenAPI 3.0）
• 主题定义：在 TOPICS 字典中硬编码
• 搜索：对文档和 OpenAPI 端点进行带评分的全文搜索

故障排除

服务无法加载：

• 确认 MCP 配置中的路径为绝对路径
• 确保已激活虚拟环境
• 检查是否已安装 mcp 包：pip show mcp

工具未显示：

• 重启 MCP 客户端
• 检查客户端日志中的初始化错误
• 确认服务启动时没有错误：python server.py

搜索无结果：

• 使用主题 ID 调用 resemble_docs_lookup，以确保获得结果
• 尝试更宽泛的搜索词
• 检查主题列表：resemble_list_topics

许可证

MIT License - 详情请参阅 LICENSE。

链接

• Resemble AI
• Resemble AI 文档
• MCP 协议