十六-MCP

【技术文档摘要】： English | 中文

<p align="center"> <img src="shiliu_logo.png" alt="ShiLiu 数字人" width="320" /> </p>

ShiLiu MCP Server — 数字人、声音克隆和视频生成

这是一个用于ShiLiu API的MCP服务器，它将数字人（头像）创建、声音克隆和视频生成带入任何兼容MCP的客户端（例如，Claude Desktop、Cline、OpenAI Agents）。它通过标准输入输出提供了一组专注于管理信用额度、列出头像和说话者、从图像/视频URL创建头像、通过文本生成视频以及轮询生成状态的工具。

• 特性：
  • 获取账户剩余信用额度
  • 列出头像和说话者
  • 从图像URL创建头像
  • 从视频URL创建头像
  • 使用选定的头像和说话者通过文本创建视频
  • 查询头像、说话者和视频的生成状态

---

要求

• Python >= 3.12
• ShiLiu API密钥 (SHILIU_API_KEY)
• 可选：uv 用于依赖管理

---

安装

# 推荐使用uv
uv sync

# 或标准pip（如果您计划开发，请使用可编辑安装）
pip install -e .

---

配置

在项目根目录创建一个.env文件或导出环境变量：

# 必需
SHILIU_API_KEY=your_api_key_here

# 可选（当前服务器运行模式不需要严格设置）
MCP_HOST=127.0.0.1
MCP_PORT=8000

在 https://shiliu.chat 获取API密钥（联系我们）。

---

本地运行

您可以直接运行服务器或通过已安装的控制台脚本运行。

# 选项1：从源码运行
python server.py --api-key YOUR_API_KEY

# 选项2：通过入口点（安装后可用）
shiliu-mcp --api-key YOUR_API_KEY

# 选项3：模块形式（如果作为包安装）
python -m shiliu_mcp.server --api-key YOUR_API_KEY

注意：

• 该服务器使用MCP FastMCP运行时，并打算由MCP客户端（基于标准输入输出）启动。
• 如果省略了--api-key，请确保在环境或.env中设置了SHILIU_API_KEY。

---

与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

---

免责声明

此项目对接ShiLiu API。请确保您有权使用API并遵守API提供商的条款。