Shi Liu 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"
      }
    }
  }
}

______________________________________________________________________

可用工具

成功响应使用 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提供商的条款。