neosapience_typecast-api-mcp-server-sample

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

本项目为Typecast API实现了MCP（模型上下文协议）服务器，可无缝集成到MCP客户端。它提供了标准化方式，能通过Model Context Protocol与Typecast API进行交互，极大提升了交互的便捷性与规范性。

🚀 快速开始

本项目实现了Typecast API的模型上下文协议服务器端，允许MCP客户端以统一的方式与Typecast API进行互动。

✨ 主要特性

| 属性 | 详情 | |------|------| | 功能实现 | 支持语音管理相关功能，如获取语音、文本转语音和播放音频 |

功能实现状态

| 功能 | 状态 | | -------------------- | ------ | | 语音管理 | | | 获取语音 | ✅ | | 文本转语音 | ✅ | | 播放音频 | ✅ |

📦 安装指南

使用Git克隆仓库

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

依赖项

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

包的安装

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

环境变量设置

设置以下环境变量：

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

在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替换为您实际项目所在的路径。

手动运行

也可以手动运行服务器：

uv run python app/main.py

🤝 贡献

欢迎任何形式的贡献！请随时提交Pull Request。

📄 许可证

MIT License