类型转换api mcp服务器
用于类型转换api的MCP服务器，实现与MCP客户端的无缝集成。该项目提供了一种通过模型上下文协议与Typecast API交互的标准化方法。
关于
此项目实现了一个模型 上下文协议服务器 对于Typecast API，允许MCP客户端以标准化的方式与Typecast API交互。
支持的型号
| 型号 | 描述 | 情绪控制 |
|---|---|---|
| ssfm-v30 | 最新型号（推荐） | 预设+智能模式 |
| ssfm-v21 | 稳定的生产型号 | 仅预设 |
ssfm-v30功能
- 7种情绪预设：正常、快乐、悲伤、愤怒、低语、调声、调声
- 智能模式：AI使用以下方式从上下文中自动推断情感
previous_text和next_text - 37种语言：扩展语言支持
功能实现状态
| 功能 | 状态 |
|---|---|
| 语音管理 | |
| 获取语音（V2 API） | ✅ |
获取声音 use_cases 筛选器 | ✅ |
| 获取语音（V2 API） | ✅ |
| 文本转语音 | ✅ |
| 文本转语音（流媒体） | ✅ |
| 文本转语音（带时间戳） | ✅ |
| 获取我的订阅 | ✅ |
| 播放音频 | ✅ |
| 输出控制 | |
target_lufs 响度标准 | ✅ |
| ssfm-v30支持 | |
| 预设模式 | ✅ |
| 智能模式 | ✅ |
| 快速语音克隆 | |
| 克隆/删除语音 | ⏳ 待定的sdk PR#32、#33产品发布 |
设置
环境变量
设置以下环境变量：
TYPECAST_API_KEY=
TYPECAST_OUTPUT_DIR= # default: ~/Downloads/typecast_output使用Claude桌面/光标
您可以将以下内容添加到您的 claude_desktop_config.json 或光标MCP设置：
推荐：使用uvx（无需安装）
{
"mcpServers": {
"typecast-api-mcp-server": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/neosapience/typecast-api-mcp-server.git",
"typecast-api-mcp-server"
],
"env": {
"TYPECAST_API_KEY": "YOUR_API_KEY",
"TYPECAST_OUTPUT_DIR": "PATH/TO/YOUR/OUTPUT/DIR"
}
}
}
}此方法自动从GitHub获取并运行服务器，无需手动克隆。
Linux用户注意事项：如果你在Linux上运行，你需要添加 XDG_RUNTIME_DIR 环境变量 env 章节：
"env": {
"TYPECAST_API_KEY": "YOUR_API_KEY",
"TYPECAST_OUTPUT_DIR": "PATH/TO/YOUR/OUTPUT/DIR",
"XDG_RUNTIME_DIR": "/run/user/1000"
}替代方案：本地安装
如果您更喜欢克隆并在本地运行：
克隆
git clone https://github.com/neosapience/typecast-api-mcp-server.git
cd typecast-api-mcp-server依赖项
此项目需要Python 3.10或更高版本，并使用 uv 用于包管理。
# Create virtual environment and install packages
uv venv
uv pip install -e .本地配置
{
"mcpServers": {
"typecast-api-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/PATH/TO/YOUR/PROJECT",
"run",
"typecast-api-mcp-server"
],
"env": {
"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许可证