| Name | elevenlabs-mcp-server JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | None |
| Summary | A Model Context Protocol server providing ElevenLabs text-to-speech integration |
| upload_time | 2024-12-26 14:08:18 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | MIT License Copyright (c) 2024 Saoud Rizwan Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
elevenlabs
llm
mcp
text-to-speech
tts
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# ElevenLabs MCP Server
A Model Context Protocol (MCP) server that integrates with ElevenLabs text-to-speech API, featuring both a server component and a sample web-based MCP Client (SvelteKit) for managing voice generation tasks.
## Features
- Generate audio from text using ElevenLabs API
- Support for multiple voices and script parts
- SQLite database for persistent history storage
- Sample SvelteKit MCP Client for:
- Simple text-to-speech conversion
- Multi-part script management
- Voice history tracking and playback
- Audio file downloads
## Installation
### Using uvx (recommended)
When using [`uvx`](https://docs.astral.sh/uv/guides/tools/), no specific installation is needed.
Add the following configuration to your MCP settings file (e.g., `cline_mcp_settings.json` for Claude Desktop):
```json
{
"mcpServers": {
"elevenlabs": {
"command": "uvx",
"args": ["elevenlabs-mcp-server"],
"env": {
"ELEVENLABS_API_KEY": "your-api-key",
"ELEVENLABS_VOICE_ID": "your-voice-id",
"ELEVENLABS_MODEL_ID": "eleven_flash_v2",
"ELEVENLABS_STABILITY": "0.5",
"ELEVENLABS_SIMILARITY_BOOST": "0.75",
"ELEVENLABS_STYLE": "0.1",
"ELEVENLABS_OUTPUT_DIR": "output"
}
}
}
}
### Development Installation
1. Clone this repository
2. Install dependencies:
```bash
uv venv
```
3. Copy `.env.example` to `.env` and fill in your ElevenLabs credentials
```json
{
"mcpServers": {
"elevenlabs": {
"command": "uv",
"args": [
"--directory",
"path/to/elevenlabs-mcp-server",
"run",
"elevenlabs-mcp-server"
],
"env": {
"ELEVENLABS_API_KEY": "your-api-key",
"ELEVENLABS_VOICE_ID": "your-voice-id",
"ELEVENLABS_MODEL_ID": "eleven_flash_v2",
"ELEVENLABS_STABILITY": "0.5",
"ELEVENLABS_SIMILARITY_BOOST": "0.75",
"ELEVENLABS_STYLE": "0.1",
"ELEVENLABS_OUTPUT_DIR": "output"
}
}
}
}
## Using the Sample SvelteKit MCP Client
1. Navigate to the web UI directory:
```bash
cd clients/web-ui
```
2. Install dependencies:
```bash
pnpm install
```
3. Copy `.env.example` to `.env` and configure as needed
4. Run the web UI:
```bash
pnpm dev
```
5. Open http://localhost:5174 in your browser
### Available Tools
- `generate_audio_simple`: Generate audio from plain text using default voice settings
- `generate_audio_script`: Generate audio from a structured script with multiple voices and actors
- `delete_job`: Delete a job by its ID
- `get_audio_file`: Get the audio file by its ID
- `list_voices`: List all available voices
- `get_voiceover_history`: Get voiceover job history. Optionally specify a job ID for a specific job.
### Available Resources
- `voiceover://history/{job_id}`: Get the audio file by its ID
- `voiceover://voices`: List all available voices
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "elevenlabs-mcp-server",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "elevenlabs, llm, mcp, text-to-speech, tts",
"author": null,
"author_email": "Mamerto Fabian <aidrivencoder@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/42/77/7d7f198f9d6c9a74d8fd56bcf1251c466cf8c8bf9c72d2a967a13ef6866e/elevenlabs_mcp_server-0.1.1.tar.gz",
"platform": null,
"description": "# ElevenLabs MCP Server\n\nA Model Context Protocol (MCP) server that integrates with ElevenLabs text-to-speech API, featuring both a server component and a sample web-based MCP Client (SvelteKit) for managing voice generation tasks.\n\n## Features\n\n- Generate audio from text using ElevenLabs API\n- Support for multiple voices and script parts\n- SQLite database for persistent history storage\n- Sample SvelteKit MCP Client for:\n - Simple text-to-speech conversion\n - Multi-part script management\n - Voice history tracking and playback\n - Audio file downloads\n\n## Installation\n\n### Using uvx (recommended)\n\nWhen using [`uvx`](https://docs.astral.sh/uv/guides/tools/), no specific installation is needed.\n\nAdd the following configuration to your MCP settings file (e.g., `cline_mcp_settings.json` for Claude Desktop):\n\n```json\n{\n \"mcpServers\": {\n \"elevenlabs\": {\n \"command\": \"uvx\",\n \"args\": [\"elevenlabs-mcp-server\"],\n \"env\": {\n \"ELEVENLABS_API_KEY\": \"your-api-key\",\n \"ELEVENLABS_VOICE_ID\": \"your-voice-id\",\n \"ELEVENLABS_MODEL_ID\": \"eleven_flash_v2\",\n \"ELEVENLABS_STABILITY\": \"0.5\",\n \"ELEVENLABS_SIMILARITY_BOOST\": \"0.75\",\n \"ELEVENLABS_STYLE\": \"0.1\",\n \"ELEVENLABS_OUTPUT_DIR\": \"output\"\n }\n }\n }\n}\n\n### Development Installation\n\n1. Clone this repository\n2. Install dependencies:\n ```bash\n uv venv\n ```\n3. Copy `.env.example` to `.env` and fill in your ElevenLabs credentials\n\n```json\n{\n \"mcpServers\": {\n \"elevenlabs\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"path/to/elevenlabs-mcp-server\",\n \"run\",\n \"elevenlabs-mcp-server\"\n ],\n \"env\": {\n \"ELEVENLABS_API_KEY\": \"your-api-key\",\n \"ELEVENLABS_VOICE_ID\": \"your-voice-id\",\n \"ELEVENLABS_MODEL_ID\": \"eleven_flash_v2\",\n \"ELEVENLABS_STABILITY\": \"0.5\",\n \"ELEVENLABS_SIMILARITY_BOOST\": \"0.75\",\n \"ELEVENLABS_STYLE\": \"0.1\",\n \"ELEVENLABS_OUTPUT_DIR\": \"output\"\n }\n }\n }\n}\n\n## Using the Sample SvelteKit MCP Client\n\n1. Navigate to the web UI directory:\n ```bash\n cd clients/web-ui\n ```\n2. Install dependencies:\n ```bash\n pnpm install\n ```\n3. Copy `.env.example` to `.env` and configure as needed\n4. Run the web UI:\n ```bash\n pnpm dev\n ```\n5. Open http://localhost:5174 in your browser\n\n### Available Tools\n\n- `generate_audio_simple`: Generate audio from plain text using default voice settings\n- `generate_audio_script`: Generate audio from a structured script with multiple voices and actors\n- `delete_job`: Delete a job by its ID\n- `get_audio_file`: Get the audio file by its ID\n- `list_voices`: List all available voices\n- `get_voiceover_history`: Get voiceover job history. Optionally specify a job ID for a specific job.\n\n### Available Resources\n\n- `voiceover://history/{job_id}`: Get the audio file by its ID\n- `voiceover://voices`: List all available voices\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2024 Saoud Rizwan Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
"summary": "A Model Context Protocol server providing ElevenLabs text-to-speech integration",
"version": "0.1.1",
"project_urls": null,
"split_keywords": [
"elevenlabs",
" llm",
" mcp",
" text-to-speech",
" tts"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b4e438c9fe43cc066bba816f1fee5e4e17f40d451fe4dc18f5571e684679fdc3",
"md5": "ea95e7faf39e754cb30d28c301dd8cdb",
"sha256": "5f0a04d1c8b5cb02e41c6f2b556a58fc2db17a3e6190a53eb955f2ee73d71308"
},
"downloads": -1,
"filename": "elevenlabs_mcp_server-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ea95e7faf39e754cb30d28c301dd8cdb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 16116,
"upload_time": "2024-12-26T14:08:17",
"upload_time_iso_8601": "2024-12-26T14:08:17.055230Z",
"url": "https://files.pythonhosted.org/packages/b4/e4/38c9fe43cc066bba816f1fee5e4e17f40d451fe4dc18f5571e684679fdc3/elevenlabs_mcp_server-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "42777d7f198f9d6c9a74d8fd56bcf1251c466cf8c8bf9c72d2a967a13ef6866e",
"md5": "d193195b7d5298900dfd98b19f287c4f",
"sha256": "38515164097d5bcde71ccb28ef2b895a11afcfa3ed1d0ec9dcb47cad22a644b5"
},
"downloads": -1,
"filename": "elevenlabs_mcp_server-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "d193195b7d5298900dfd98b19f287c4f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 108788,
"upload_time": "2024-12-26T14:08:18",
"upload_time_iso_8601": "2024-12-26T14:08:18.892321Z",
"url": "https://files.pythonhosted.org/packages/42/77/7d7f198f9d6c9a74d8fd56bcf1251c466cf8c8bf9c72d2a967a13ef6866e/elevenlabs_mcp_server-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-26 14:08:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "elevenlabs-mcp-server"
}
