ssave.cc — TikTok & Instagram Downloader

@ssavecc/mcp-server

用于 Ssave.cc 的模型上下文协议（MCP）服务 — 直接将 TikTok / Instagram / YouTube / Douyin 媒体（无水印高清视频、MP3 音频）提取并下载到本地磁盘。

通过 stdio 在本地运行，由 Ssave Open API（/open/v1）提供支持。免费套餐无需注册。

快速开始

npx @ssavecc/mcp-server

然后将其添加到 MCP 客户端：

Claude Code

claude mcp add ssave -- npx @ssavecc/mcp-server

或使用项目级 .mcp.json：

{
  "mcpServers": {
    "ssave": { "command": "npx", "args": ["@ssavecc/mcp-server"] }
  }
}

Cursor

设置 → MCP → 添加新的 MCP 服务：

{
  "mcpServers": {
    "ssave": {
      "command": "npx",
      "args": ["@ssavecc/mcp-server"]
    }
  }
}

Claude Desktop

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "ssave": {
      "command": "npx",
      "args": ["@ssavecc/mcp-server"]
    }
  }
}

工具

工具	描述
extract_media	从 TikTok / Instagram / YouTube / Douyin URL 中提取元数据和可用格式。返回一个 ssv_ 令牌（5–15 分钟后过期）以及每种格式对应的下载 URL。
download_media	将提取的媒体流式下载到本地磁盘（默认目录为 ~/Downloads/ssave/，可通过 output_dir 覆盖）。返回绝对路径和文件大小。
get_thumbnail	将媒体缩略图保存到本地磁盘（通过代理获取，不会暴露源 CDN 链接）。

典型流程：extract_media(url) → 获取返回的 id → download_media(id, type: "hd" | "watermark" | "mp3")。

环境变量

全部为可选项：

变量	默认值	描述
SSAVE_API_BASE_URL	https://api.ssave.cc	用于本地开发的覆盖值（例如 http://localhost:8000）。
SSAVE_API_KEY	—	为付费套餐预留（第 3 阶段）：作为 Authorization: Bearer <key> 发送。
SSAVE_OUTPUT_DIR	~/Downloads/ssave/	未传入 output_dir 时使用的默认输出目录。

速率限制（免费套餐）

与 Ssave Open API 共享，按 IP 和 UTC 日期计算：

操作	限制
extract	每天 10 次
download	每天 50 次

遇到 429 rate_limited 时，工具会报告 UTC 重置时间。

开发

npm install
npm run dev        # run server on stdio (connect with MCP Inspector: npx @modelcontextprotocol/inspector)
npm test           # unit tests (mock fetch)
npm run build      # compile to dist/

法律声明

仅用于归档你有权访问的内容。请遵守平台服务条款。禁止批量下载。请参阅 ssave.cc/privacy。

许可证

MIT