neosapience/typecast-api-mcp-server
If you are the rightful owner of typecast-api-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
MCP Server for typecast-api, enabling seamless integration with MCP clients.
typecast-api-mcp-server
MCP Server for typecast-api, enabling seamless integration with MCP clients. This project provides a standardized way to interact with Typecast API through the Model Context Protocol.
About
This project implements a Model Context Protocol server for Typecast API, allowing MCP clients to interact with the Typecast API in a standardized way.
Feature Implementation Status
| Feature | Status |
|---|---|
| Voice Management | |
| Get Voices | ✅ |
| Text to Speech | ✅ |
| Play Audio | ✅ |
Setup
Environment Variables
Set the following environment variables:
TYPECAST_API_KEY=<your-api-key>
TYPECAST_OUTPUT_DIR=<your-output-directory> # default: ~/Downloads/typecast_output
Usage with Claude Desktop / Cursor
You can add the following to your claude_desktop_config.json or Cursor MCP settings:
Recommended: Using uvx (No installation required)
{
"mcpServers": {
"typecast-api-mcp-server": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/neosapience/typecast-api-mcp-server.git",
"typecast-api-mcp-server"
],
"env": {
"TYPECAST_API_KEY": "YOUR_API_KEY",
"TYPECAST_OUTPUT_DIR": "PATH/TO/YOUR/OUTPUT/DIR"
}
}
}
}
This method automatically fetches and runs the server from GitHub without manual cloning.
Note for Linux users: If you're running on Linux, you need to add the XDG_RUNTIME_DIR environment variable to the env section:
"env": {
"TYPECAST_API_KEY": "YOUR_API_KEY",
"TYPECAST_OUTPUT_DIR": "PATH/TO/YOUR/OUTPUT/DIR",
"XDG_RUNTIME_DIR": "/run/user/1000"
}
Alternative: Local Installation
If you prefer to clone and run locally:
Git Clone
git clone https://github.com/neosapience/typecast-api-mcp-server.git
cd typecast-api-mcp-server
Dependencies
This project requires Python 3.10 or higher and uses uv for package management.
# Create virtual environment and install packages
uv venv
uv pip install -e .
Local Configuration
{
"mcpServers": {
"typecast-api-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/PATH/TO/YOUR/PROJECT",
"run",
"typecast-api-mcp-server"
],
"env": {
"TYPECAST_API_KEY": "YOUR_API_KEY",
"TYPECAST_OUTPUT_DIR": "PATH/TO/YOUR/OUTPUT/DIR"
}
}
}
}
Replace /PATH/TO/YOUR/PROJECT with the actual path where your project is located.
Manual Execution
You can also run the server manually:
uv run python app/main.py
Contributing
Contributions are always welcome! Feel free to submit a Pull Request.
License
MIT License
