石柳MCP服务器——数字人、语音克隆和视频生成
用于ShiLiu API的MCP服务器，将数字人（化身）创建、语音克隆和视频生成带入任何与MCP兼容的客户端（例如Claude Desktop、Cline、OpenAI Agent）。它在stdio上公开了一组专注的工具，用于管理积分、列出化身和演讲者、从图像/视频URL创建化身、按文本生成视频以及轮询生成状态。
- 特征：
- 检索您帐户的剩余积分 - 列出头像和发言人 - 从图像URL创建头像 - 从视频URL创建头像 - 使用选定的头像和扬声器通过文本创建视频 - 查询化身、演讲者和视频的生成状态
______________________________________________________________________
需求
- Python>=3.12
- A ShiLiu API密钥(
SHILIU_API_KEY) - 可选：
uv用于依赖关系管理
______________________________________________________________________
安装
# Recommended with uv
uv sync
# Or standard pip (editable install if you plan to develop)
pip install -e .______________________________________________________________________
配置
创建一个 .env 项目根目录中的文件或导出环境变量：
# Required
SHILIU_API_KEY=your_api_key_here
# Optional (not strictly required by current server run mode)
MCP_HOST=127.0.0.1
MCP_PORT=8000在获取API密钥 https://shiliu.chat （联系我们）。
______________________________________________________________________
在本地运行
您可以直接或通过安装的控制台脚本运行服务器。
# Option 1: run from source
python server.py --api-key YOUR_API_KEY
# Option 2: via entrypoint (available after install)
shiliu-mcp --api-key YOUR_API_KEY
# Option 3: module form (if installed as a package)
python -m shiliu_mcp.server --api-key YOUR_API_KEY笔记：
- 服务器使用MCP FastMCP运行时，旨在由MCP客户端（基于stdio）启动。
- 如果
--api-key省略，确保SHILIU_API_KEY设置在环境中或.env.
______________________________________________________________________
与MCP客户端一起使用
Claude Desktop示例（根据需要调整路径/命令）：
{
"mcpServers": {
"shiliu": {
"command": "python",
"args": ["server.py"],
"env": {
"SHILIU_API_KEY": "your_api_key_here"
}
}
}
}如果使用可执行命令安装(shiliu-mcp):
{
"mcpServers": {
"shiliu": {
"command": "shiliu-mcp",
"args": [],
"env": {
"SHILIU_API_KEY": "your_api_key_here"
}
}
}
}______________________________________________________________________
可用工具
| 工具 | 描述 | 参数 |
|---|---|---|
get_remaining_credits | 获取剩余积分 | - |
get_avatar_list | 列出可用头像 | - |
create_avatar_by_image | 通过图像URL创建头像 | image_url, title? |
create_avatar_by_video | 通过视频URL创建头像 | video_url, title? |
get_avatar_generation_status | 查询头像生成状态 | avatar_id |
get_speaker_list | 列出可用发言人 | - |
create_speaker | 创建新的扬声器（语音） | title? |
get_speaker_generation_status | 查询扬声器生成状态 | speaker_id |
create_video_by_text | 按文本创建视频 | avatar_id, speaker_id, text, title? |
get_video_generation_status | 查询视频生成状态 | video_id |
成功响应使用 code = 0 并包括相关领域，如 remaining_credits, avatars, speakers, video_id, progress, status, title, video_url等等。
______________________________________________________________________
故障排除
- API关键错误
- 确保 .env 存在或 SHILIU_API_KEY 已出口
- 网络问题
- 验证与的连接 https://api.16ai.chat
- 依赖性问题
- 重新安装 uv sync 或 pip install -e .
______________________________________________________________________
开发说明
- 代码入口点：
server.py（CLI解析--api-key,--host,--port,--reload) - 主要类别和型号如下
api_client.py - 打包元数据在中定义
pyproject.toml
______________________________________________________________________
免责声明
本项目与API接口。请确保您有权使用API并遵守API提供商的条款。