io.github.vicseeai/vicsee-mcp-server
Generate, edit and upscale AI video and images from any agent via VicSee.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http vicsee-mcp-server 'https://mcp.vicsee.com'
{
"mcpServers": {
"vicsee-mcp-server": {
"type": "http",
"url": "https://mcp.vicsee.com"
}
}
}
@vicsee/mcp-serverclaude mcp add vicsee-mcp-server -e 'VICSEE_API_KEY=<your vicsee_api_key>' -- npx -y @vicsee/mcp-server@0.3.3
{
"mcpServers": {
"vicsee-mcp-server": {
"command": "npx",
"args": [
"-y",
"@vicsee/mcp-server@0.3.3"
],
"env": {
"VICSEE_API_KEY": "<your vicsee_api_key>"
}
}
}
}
Variables d'environnement
VICSEE_API_KEYobligatoire secret VicSee API key (starts with sk-) from vicsee.com Settings then API. Requires a paid plan or credit pack.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
VicSee MCP Server
Generate, edit, and upscale AI video & images from any agent — VicSee as a set of MCP tools.
Works with Hermes Agent, Claude (Desktop / Code), Cursor, OpenClaw, and any MCP-compatible client.
What your agent can do
| Tool | What it does |
|---|---|
vicsee_list_models | List available models (Seedance, Veo, Kling, FLUX, Nano Banana, …) + their credit costs |
vicsee_estimate | Same arguments as vicsee_generate; returns the exact credits it will charge and creates nothing |
vicsee_generate | Text/image → video or image with a chosen model |
vicsee_get_task | Poll a task and get the finished media URL (result.expires_at — URLs are kept 7 days; download what you want to keep) |
vicsee_upscale_image | Upscale an image |
vicsee_upscale_video | Upscale a video |
vicsee_get_credits | Check your credit balance |
Generation is asynchronous: vicsee_generate (or vicsee_upscale_*) returns a task id
immediately — your agent then polls vicsee_get_task until status is completed and reads the
URL from result.url.
Setup
- Get an API key at vicsee.com → Settings → API (starts with
sk-). API access requires a paid plan or credit pack. - Add the server to your MCP client config with that key:
{
"mcpServers": {
"vicsee": {
"command": "npx",
"args": ["-y", "@vicsee/mcp-server"],
"env": { "VICSEE_API_KEY": "sk-your-key-here" }
}
}
}
That's the whole setup — drop in your key, and your agent can generate.
Client config locations
- Claude Desktop:
claude_desktop_config.json→mcpServers - Cursor: Settings → MCP → add server (same
command/args/env) - Hermes Agent / OpenClaw: add to the MCP servers section of your agent config
- Claude Code:
claude mcp add vicsee -e VICSEE_API_KEY=sk-... -- npx -y @vicsee/mcp-server
Optional env
VICSEE_BASE_URL— override the API base URL (defaults tohttps://vicsee.com/api/v1).
Local development
pnpm install
pnpm build
VICSEE_API_KEY=sk-... node dist/index.js # stdio server
# or run from source: VICSEE_API_KEY=sk-... pnpm dev
Point your MCP client at the local build by using "command": "node", "args": ["/abs/path/to/dist/index.js"].
Example agent flow
"Make me a 5-second video of a kitten chasing a laser."
vicsee_list_models(type: video) → pick e.g.seedance-2-5-text-to-video(up to 30s) orseedance-2-0-text-to-video(adds 1080p/4K)vicsee_generate(model, prompt, duration: 5) →{ id, status: "pending" }vicsee_get_task(id) … poll … →{ status: "completed", result: { url: "https://cdn.vicsee.com/…" } }
Notes
- Result URLs are served from
cdn.vicsee.com— stable VicSee CDN links. - Each generation costs credits; see
vicsee_list_modelsfor per-model costs andvicsee_get_creditsfor your balance.
License
MIT
Questions fréquentes
Qu'est-ce que io.github.vicseeai/vicsee-mcp-server ?
Generate, edit and upscale AI video and images from any agent via VicSee.
Comment installer io.github.vicseeai/vicsee-mcp-server ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http vicsee-mcp-server 'https://mcp.vicsee.com'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.vicseeai/vicsee-mcp-server ?
Oui. Il attend VICSEE_API_KEY, à renseigner dans sa configuration.
io.github.vicseeai/vicsee-mcp-server est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.vicseeai/vicsee-mcp-server ?
Il est publié par vicseeai. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.