@ssave/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 @ssave/mcp-server

Then add it to your MCP client:

Claude Code

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

Or project-level .mcp.json:

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

Cursor

Settings → MCP → Add new MCP server:

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

Claude Desktop

Edit claude_desktop_config.json:

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

Related MCP server: MCP YouTube Downloader

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