deepgram-mcp
If you are the rightful owner of deepgram-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Deepgram MCP Server integrates with Claude Desktop for real-time audio generation from text input using the Deepgram API.
Deepgram MCP Server
This is a Deepgram MCP (Modular Communication Protocol) server that integrates with Claude Desktop to provide real-time audio generation from text input. It leverages the Deepgram API for audio processing and plays back the generated audio within your MCP-compatible client.
Demo
Features
- Converts text to audio using Deepgram
- Plays audio in real-time
- Easy to configure and run locally
🚀 Getting Started
Prerequisites
- Python 3.13 or higher installed on your machine
- A Deepgram API key (Get one here)
- Claude Desktop or any other MCP client like Cursor app installed
🛠️ Installation
Step 1: Clone the Repository
git clone https://github.com/your-username/deepgram-mcp.git
cd deepgram-mcp
Step 2: Install Dependencies
This project uses Poetry for dependency management.
Install Poetry (if not already installed):
curl -sSL https://install.python-poetry.org | python3 -
Install project dependencies:
poetry install
Alternatively, you can manually install from pyproject.toml
:
pip install -r requirements.txt
🧩 MCP Server Setup in Claude
Step 3: Register MCP Server in Claude Desktop
- Open Claude Desktop.
- Go to Settings → Developer Settings.
- Click Edit Config to modify the configuration JSON.
- If the config is empty, add the following block. Otherwise, merge this configuration under the
mcpServers
section.
⚠️ Replace:
//path to python
with the full path to your Python interpreter./absolute/path/to/server.py
with the absolute path to theserver.py
file in this repository.DEEPGRAM_API_KEY
with your actual Deepgram API key.
{
"mcpServers": {
"deepgram-mcp": {
"command": "/usr/bin/python3",
"args": [
"/Users/your-username/path/to/deepgram-mcp/server.py"
],
"env": {
"DEEPGRAM_API_KEY": "your-deepgram-api-key"
},
"description": "Deepgram MCP server to transcribe audio. It is a STT server that uses the Deepgram API to transcribe audio."
}
}
}
🧪 Testing the Integration
- Restart Claude Desktop after saving the configuration.
- Trigger the MCP client to use the
deepgram-mcp
server. - You should hear audio generated from your text input.
📁 Project Structure
deepgram-mcp/
│
├── server.py # Entry point for the MCP server
├── pyproject.toml # Dependency & package management
└── README.md # Documentation
🙋♂️ Support
For issues or questions, feel free to open an issue or contact the maintainer.