AI导哈

数字人视频生成服务

一个MCP服务器，提供数字人（头像）创建、语音克隆和视频生成功能，适用于任何MCP兼容客户端。

  • by shiliu-ai
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 shiliu-ai/ShiLiu-MCP

使用说明

英语 | 中文

石柳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提供商的条款。

相关 MCP