🚀 类型转换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=
TYPECAST_OUTPUT_DIR= # 默认：~/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