What is Neosapience Typecast Api Mcp Server Sample

The neosapience_typecast-api-mcp-server-sample is a sample MCP Server for the Typecast API, enabling seamless integration with MCP clients through the Model Context Protocol.

Use cases

Use cases include creating voice-enabled applications, enhancing user interaction in software, and developing tools for accessibility that require text-to-speech capabilities.

How to use

To use the neosapience_typecast-api-mcp-server-sample, clone the repository, set up the environment variables, and configure your MCP client (like Claude Desktop) to connect to the server. You can also run the server manually using the provided commands.

Key features

Key features include voice management functionalities such as getting voices, text-to-speech conversion, and playing audio.

Where to use

This MCP Server can be used in applications requiring voice synthesis and audio playback, such as virtual assistants, interactive voice response systems, and other multimedia applications.

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 for Typecast API, allowing MCP clients to interact with the Typecast API in a standardized way.

Feature Implementation Status

Setup

Git Clone

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

# Create virtual environment and install packages
uv venv
uv pip install -e .

Environment Variables

Set the following environment variables:

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:

{
  "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:

uv run python app/main.py

Contributing

Contributions are always welcome! Feel free to submit a Pull Request.

License

MIT License