ssave-mcp-server
MCP server that extracts and downloads TikTok, Instagram, YouTube, and Douyin media (HD video, MP3) directly to local disk via the Ssave Open API.
README
@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
| Tool | Description |
|---|---|
extract_media |
Extract metadata and available formats from a TikTok / Instagram / YouTube / Douyin URL. Returns an ssv_ token (expires in 5–15 min) plus per-format download URLs. |
download_media |
Stream the extracted media to local disk (default ~/Downloads/ssave/, override with output_dir). Returns the absolute path and size. |
get_thumbnail |
Save the media thumbnail to local disk (proxied — never exposes the source CDN link). |
Typical flow: extract_media(url) → take the returned id → download_media(id, type: "hd" | "watermark" | "mp3").
Environment Variables
All optional:
| Variable | Default | Description |
|---|---|---|
SSAVE_API_BASE_URL |
https://api.ssave.cc |
Override for local development (e.g. http://localhost:8000). |
SSAVE_API_KEY |
— | Reserved for paid tier (Phase 3): sent as Authorization: Bearer <key>. |
SSAVE_OUTPUT_DIR |
~/Downloads/ssave/ |
Default output directory when output_dir is not passed. |
Rate Limits (free tier)
Shared with the Ssave Open API, per IP per UTC day:
| Operation | Limit |
|---|---|
extract |
10 / day |
download |
50 / 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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.