typecast-api-mcp-server-sample

🚀 类型转换API - MCP服务器示例

本项目为Typecast API实现了MCP服务器，支持与MCP客户端无缝集成。通过Model Context Protocol，提供了一种标准化的方式与Typecast API进行交互，让开发者能够更便捷地使用相关功能。

🚀 快速开始

1. Git克隆

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

2. 依赖项安装

该项目需要Python 3.10或更高版本，并使用uv进行包管理。

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

3. 环境变量设置

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

4. 与Claude Desktop一起使用

您可以在claude_desktop_config.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"
      }
    }
  }
}

请将/PATH/TO/YOUR/PROJECT替换为您实际项目的路径。

5. 手动执行

您也可以手动运行服务器：

uv run python app/main.py

✨ 主要特性

该项目实现了Typecast API的Model 上下文协议服务器，允许MCP客户端以标准化的方式与Typecast API交互。以下是部分功能的实现状态： | 功能 | 状态 | | ----------------- | ---- | | 语音管理 | | | 获取语音 | ✅ | | 文本转语音 | ✅ | | 播放音频 | ✅ |

📄 许可证

本项目采用MIT License。

贡献

欢迎任何贡献！请随时提交拉取请求。