@ssavecc/mcp-server

Model Context Protocol (MCP) server for Ssave.cc — extract and download TikTok / Instagram / YouTube / Douyin media (HD video without watermark, MP3 audio) directly to your local disk.

Runs locally via stdio, backed by the Ssave Open API (`/open/v1`). No registration required on the free tier.

Quick Start

npx @ssavecc/mcp-server

Then add it to your MCP client:

Claude Code

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

Or project-level `.mcp.json`:

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

Cursor

Settings → MCP → Add new MCP server:

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

Claude Desktop

Edit `claude_desktop_config.json`:

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

Tools

Typical flow: `extract_media(url)` → take the returned `id` → `download_media(id, type: "hd" | "watermark" | "mp3")`.

Environment Variables

All optional:

Rate Limits (free tier)

Shared with the Ssave Open API, per IP per UTC day:

On `429 rate_limited` the tool reports the UTC reset time.

Development

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/

Legal

For personal archiving of content you have access to. Respect platform Terms of Service. No bulk downloading. See ssave.cc/privacy.

License

MIT