ElevenLabs MCP Server

# ElevenLabs MCP Server - Project Summary ## 🎉 What Was Created A complete MCP (Model Context Protocol) server for the ElevenLabs API, ready to deploy on Smithery or run locally. ## 📦 Project Structure ``` elevenlabs-mcp/ ├── src/ │ └── index.js # Main MCP server implementation (14 tools) ├── node_modules/ # Dependencies ├── .gitignore # Git ignore file ├── example.config.json # Example configuration ├── package.json # Project metadata and scripts ├── package-lock.json # Dependency lock file ├── README.md # Project overview and setup ├── smithery.config.json # Smithery deployment config ├── USAGE.md # Comprehensive usage guide └── SUMMARY.md # This file ``` ## ✨ Features Implemented ### 14 MCP Tools Covering All Major ElevenLabs APIs: #### Text-to-Speech (2 tools) 1. **text-to-speech** - Convert text to speech with full control 2. **text-to-speech-streaming** - Real-time streaming audio generation #### Voice Management (3 tools) 3. **get-voices** - List all available voices with filtering 4. **get-voice** - Get detailed information about a specific voice 5. **get-models** - List all available AI models #### Audio Transformation (3 tools) 6. **speech-to-speech** - Voice changer (transform one voice to another) 7. **sound-generation** - Create sound effects from text 8. **audio-isolation** - Remove background noise from audio #### History & Account (6 tools) 9. **get-history** - Get history of generated audio 10. **get-history-item** - Get specific history item details 11. **get-history-item-audio** - Download audio from history 12. **delete-history-item** - Delete a history item 13. **get-user** - Get user account information 14. **get-subscription** - Get subscription details and limits ## 🚀 How to Use ### Prerequisites - Node.js 18+ installed - An ElevenLabs API key from [ElevenLabs Settings](https://elevenlabs.io/app/settings/api-keys) ### Option 1: Local Development ```bash # Install dependencies npm install # Start development server npm run dev ``` The Smithery CLI will give you a playground URL to test your server. ### Option 2: Deploy to Smithery 1. Create a GitHub repository 2. Push this code to GitHub: ```bash git init git add . git commit -m "Initial commit: ElevenLabs MCP server" git remote add origin YOUR_GITHUB_REPO_URL git push -u origin main ``` 3. Go to [smithery.ai](https://smithery.ai) 4. Click "Deploy" and connect your repository 5. Configure your API key in the Smithery dashboard ### Option 3: Use with Claude Desktop / Cursor Add to your MCP settings: ```json { "mcpServers": { "elevenlabs": { "url": "https://your-smithery-deployment-url", "config": { "apiKey": "your-elevenlabs-api-key" } } } } ``` ## 🎯 Quick Examples ### Generate Speech ``` "Use text-to-speech to convert 'Hello, world!' to speech using voice ID 21m00Tcm4TlvDq8ikWAM" ``` ### List Available Voices ``` "Show me all available voices" ``` ### Create Sound Effect ``` "Create a sound effect of a dog barking" ``` ### Check Account Info ``` "What's my current ElevenLabs subscription status?" ``` ## 📚 Documentation Files - **README.md** - Project overview, installation, and basic usage - **USAGE.md** - Comprehensive guide with all tools, parameters, and examples - **example.config.json** - Example configuration file - **smithery.config.json** - Smithery deployment configuration ## 🔧 Configuration The server requires only ONE configuration parameter: - **apiKey** (required): Your ElevenLabs API key Get your API key from: https://elevenlabs.io/app/settings/api-keys ## 📦 Dependencies - `@modelcontextprotocol/sdk` - MCP SDK for building servers - `@smithery/sdk` - Smithery SDK for deployment - `zod` - Schema validation - `@smithery/cli` (dev) - CLI for development and deployment ## 🎨 Supported Features ### Audio Formats - MP3 (various bitrates: 32, 64, 96, 128, 192 kbps) - PCM (various sample rates: 16, 22.05, 24, 44.1 kHz) - μ-law (for Twilio integration) ### Voice Types - Pre-made voices - Cloned voices - Generated voices - Professional voices - Community voices ### Models - Multilingual models - English-specific models - Turbo models (lower latency) - Flash models (fastest) ## 🔐 Security - API key is required and validated - All requests use HTTPS - No credentials stored in code - Supports zero-retention mode (enterprise feature) ## 📈 Next Steps 1. **Test the server**: Run `npm run dev` and test in the playground 2. **Deploy to Smithery**: Push to GitHub and deploy via Smithery 3. **Integrate with your AI**: Use with Claude Desktop, Cursor, or any MCP client 4. **Customize**: Add more tools or modify existing ones as needed ## 🤝 ElevenLabs API Coverage This server implements the complete ElevenLabs API v1 as documented at: https://elevenlabs.io/docs/api-reference/introduction All major endpoints are covered: - ✅ Text-to-Speech - ✅ Streaming - ✅ Speech-to-Speech (Voice Changer) - ✅ Sound Effects - ✅ Audio Isolation - ✅ Voice Management - ✅ Model Management - ✅ History - ✅ User & Subscription ## 💡 Tips 1. **Popular voices**: Use Rachel (21m00Tcm4TlvDq8ikWAM) or Adam (pNInz6obpgDQGcFmaJgB) for quick tests 2. **Streaming**: Use streaming endpoint for real-time applications 3. **Caching**: Cache voice IDs to avoid repeated lookups 4. **Monitoring**: Check subscription limits regularly with get-subscription 5. **Quality vs Speed**: Use lower bitrates (mp3_22050_32) for faster generation ## 🐛 Troubleshooting - **401 Error**: Check your API key - **429 Error**: Rate limited - wait or upgrade plan - **422 Error**: Invalid parameters - check the tool schema - **Audio issues**: Verify base64 decoding and MIME types ## 📞 Support Resources - [ElevenLabs Docs](https://elevenlabs.io/docs) - [ElevenLabs Discord](https://discord.gg/elevenlabs) - [MCP Docs](https://modelcontextprotocol.org/) - [Smithery Docs](https://smithery.ai/docs) ## ✅ Ready to Deploy! Your ElevenLabs MCP server is complete and ready to use. Simply add your API key and start generating audio!