Question 1

What is the Resemble AI Voice Generation MCP Server?

Accepted Answer

It's a server implementation that bridges Resemble AI's voice generation API with platforms like Claude and Cursor, using the Model Context Protocol (MCP) to enable AI agents to generate realistic voice audio from text.

Question 2

What is MCP?

Accepted Answer

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs, allowing AI models to access and interact with external data sources and tools.

Question 3

What are the main features of this server?

Accepted Answer

Key features include generating voice audio from text, listing available voice models, supporting multiple connection methods (SSE and StdIO), and providing flexible audio output options (file or base64).

Question 4

What connection methods does the server support?

Accepted Answer

The server supports SSE Transport (Network-based Server-Sent Events) and StdIO Transport (Direct process communication).

Question 5

What are the prerequisites for using the server?

Accepted Answer

You need Python 3.10 or higher and a Resemble AI API key.

Question 6

How do I set up the Resemble AI API key?

Accepted Answer

You can set it as an environment variable (`RESEMBLE_API_KEY`) or create a `.env` file in the project root with the same variable.

Question 7

How do I run the server?

Accepted Answer

You can use the `run_server.sh` script or the CLI directly (`python -m src.cli`). Choose the implementation and port as needed.

Question 8

How do I connect to Claude Desktop?

Accepted Answer

Create a `claude_desktop_config.json` file with the appropriate configuration for SSE or StdIO transport.

Question 9

How do I connect to Cursor?

Accepted Answer

Go to Settings → AI → MCP Servers in Cursor and add a new server, selecting either SSE or Subprocess (StdIO) as the connection type, and configure the URL or command accordingly.

Question 10

What tools are available?

Accepted Answer

The server provides the `list_voices` tool (to list available voice models) and the `generate_tts` tool (to generate voice audio from text).

Question 11

What are the parameters for the `generate_tts` tool?

Accepted Answer

Required parameters are `text` (the text to convert) and `voice_id` (the ID of the voice to use). Optional parameters are `return_type` ('file' or 'base64', default: 'file') and `output_filename` (optional).

Question 12

What implementations are included in the project?

Accepted Answer

The project includes `resemble_mcp_server.py` (MCP SDK with SSE), `resemble_stdio_server.py` (StdIO transport), `resemble_http_server.py` (HTTP with SSE), `resemble_ai_server.py` (Direct API), and `resemble_ai_sdk_server.py` (Resemble SDK).

Question 13

What should I do if I encounter MCP SDK import errors?

Accepted Answer

The server will automatically fall back to the HTTP implementation with SSE transport.

Question 14

What should I check if Claude or Cursor cannot connect to the server?

Accepted Answer

Verify that the server is running, the correct URL is configured, your API key is valid, and check the server logs for errors.

Question 15

When should I use SSE Transport vs. StdIO Transport?

Accepted Answer

Use SSE Transport when you want to run the server separately, or on a different machine. Use StdIO Transport when you want Claude/Cursor to manage the server process for you.

Question 16

What Python version is required?

Accepted Answer

Python 3.10 or higher is required.

Question 17

Where can I find example usage?

Accepted Answer

Examples can be found in the `examples/` directory.

Question 18

Where is the generated audio output stored?

Accepted Answer

By default, audio files are stored in the `output/` directory. This can be configured in the `.env` file.

Question 19

What if I get an API connection error?

Accepted Answer

Ensure you are using the correct API endpoint (`https://app.resemble.ai/api/v2/`) and that your API key is valid.

Question 20

Do I need a project in my Resemble AI account?

Accepted Answer

Yes, the API requires at least one project in your Resemble account. Create one through the Resemble AI dashboard if needed.

Question 21

What do I do if Cursor fails to connect via SSE?

Accepted Answer

Ensure the server is running on the specified port, you're using the correct `/sse` endpoint, no firewall is blocking the connection, and try restarting both the server and Cursor.

Resemble AI Voice Generation

Resources

Project Details

Recomended MCP Servers

Featured Templates

AI Voice Assistant (Voice-Text-Voice)

Image to text with Claude 3

Speech to Text

AI Chatbot Starter Kit v0.1

Calculate Time Complexity with ChatGPT API

Talk with Claude 3

Start your free trial