typecast-api-mcp-server-sample

typecast-api-mcp-server-sample

2025.04.13 0

Python语音合成API集成内容生成

该服务是一个基于Model Context Protocol（MCP）的Typecast API服务器示例，旨在通过标准化协议实现与Typecast API的无缝集成。它提供了语音管理功能，包括获取语音列表、文本转语音和播放音频等核心功能。

View on GitHub

Overview

基本能力

产品定位

该服务是一个MCP服务器，用于与Typecast API集成，通过Model Context Protocol提供标准化的交互方式。

核心功能

语音管理
获取语音列表（Get Voices）
文本转语音（Text to Speech）
播放音频（Play Audio）

适用场景

需要将文本转换为语音的应用场景
需要播放音频的应用场景
需要与Typecast API集成的开发项目

工具列表

uv：用于Python包管理和虚拟环境管理

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

确保系统已安装Python 3.10或更高版本
安装uv工具

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

安装教程

克隆项目仓库

git clone https://github.com/hyunseung/typecast-api-mcp-server-sample.git
cd typecast-api-mcp-server-sample

设置环境变量

TYPECAST_API_HOST=https://api.typecast.ai
TYPECAST_API_KEY=<your-api-key>
TYPECAST_OUTPUT_DIR=<your-output-directory> # default: ~/Downloads/typecast_output

调试方式

手动运行服务器

uv run python app/main.py

通过Claude Desktop配置运行

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

许可证

该项目遵循 MIT 开源许可条款。