Resemble AI

Resemble AI MCP Server

Resemble AI のドキュメントをリソースおよびツールとして公開する公式 MCP サーバーです。Cursor、Claude Code、または MCP 対応クライアントに接続すると、開発中にコーディングアシスタントから Resemble AI のドキュメントにアクセスできるようになります。

概要

これは Resemble AI の公式 MCP サーバーです。Model Context Protocol（stdio トランスポート）を実装し、docs/pages/ のドキュメントをクエリ可能なリソースとして提供します。トピックごとにドキュメントを集約し、すべての MDX ファイルを対象とした全文検索を提供します。

提供する機能：

• トピック別のドキュメント集約（voice-cloning、text-to-speech、agents など、13 トピック）
• すべての MDX ドキュメントページを対象とした全文検索
• コード生成に使える正確なリクエスト／レスポンススキーマを含む OpenAPI 3.0 仕様
• ページおよびエンドポイントへの直接アクセス

接続すると、コーディングアシスタントから Resemble AI のドキュメントをプログラムで検索できるようになります。アシスタントがガイド、チュートリアル、正確な 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）またはご利用の OS に応じた同等の場所に追加します。

{
  "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 ストリーミングサービスを作って」と依頼すると、text-to-speech トピックに対して resemble_docs_lookup が呼び出され、正確なリクエストスキーマを取得して正確に実装するために 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 のコーディングエージェント
• Claude Desktop - Anthropic のデスクトップアプリ
• その他の MCP 対応クライアント

開発

このサーバーは、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 プロトコル