typecast-api-mcp-server-sample

基本能力

产品定位

typecast-api-mcp-server-sample 是一个基于 Model Context Protocol (MCP) 的服务，用于与 Typecast API 进行标准化交互。

核心功能

• 语音管理
• 获取语音 (Get Voices)
• 文本转语音 (Text to Speech)
• 播放音频 (Play Audio)

适用场景

• 需要通过 API 进行语音合成的应用
• 需要标准化语音管理接口的开发项目
• 与 MCP 客户端集成的语音服务

工具列表

• uv: 用于包管理和虚拟环境管理
• Python 3.10+: 运行环境

常见问题解答

• 需要设置环境变量 TYPECAST_API_HOST, TYPECAST_API_KEY 和 TYPECAST_OUTPUT_DIR
• 可以通过 Claude Desktop 配置集成

使用教程

使用依赖

系统要求

• Python 3.10 或更高版本
• uv 包管理器

安装依赖

# 创建虚拟环境并安装包
uv venv
uv pip install -e .

安装教程

1. 克隆仓库

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

1. 设置环境变量

TYPECAST_API_HOST=https://api.typecast.ai
TYPECAST_API_KEY=<your-api-key>
TYPECAST_OUTPUT_DIR=<your-output-directory> # 默认: ~/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 开源许可条款。