Content
# typecast-api-mcp-server-sample
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](https://modelcontextprotocol.io/introduction) 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
### Git Clone
```bash
git clone https://github.com/hyunseung/typecast-api-mcp-server-sample.git
cd typecast-api-mcp-server-sample
```
### Dependencies
This project requires Python 3.10 or higher and uses `uv` for package management.
#### Package Installation
```bash
# Create virtual environment and install packages
uv venv
uv pip install -e .
```
### Environment Variables
Set the following environment variables:
```bash
TYPECAST_API_HOST=https://api.typecast.ai
TYPECAST_API_KEY=<your-api-key>
TYPECAST_OUTPUT_DIR=<your-output-directory> # default: ~/Downloads/typecast_output
```
### Usage with Claude Desktop
You can add the following to your `claude_desktop_config.json`:
#### Basic Configuration:
```json
{
"mcpServers": {
"typecast-api-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/PATH/TO/YOUR/PROJECT",
"run",
"typecast-api-mcp-server"
],
"env": {
"TYPECAST_API_HOST": "https://api.typecast.ai",
"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:
```bash
uv run python app/main.py
```
## Contributing
Contributions are always welcome! Feel free to submit a Pull Request.
## License
MIT License
Connection Info
You Might Also Like
MarkItDown MCP
Converting files and office documents to Markdown.
Time
Obtaining current time information and converting time between different...
Filesystem
Model Context Protocol Servers
Sequential Thinking
Offers a structured approach to dynamic and reflective problem-solving,...
Git
Model Context Protocol Servers
Context 7
Context7 MCP Server -- Up-to-date code documentation for LLMs and AI code editors