English Français العربية

io.github.vicseeai/vicsee-mcp-server

السجل الرسمي الوسائط والتصميم

Generate, edit and upscale AI video and images from any agent via VicSee.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http vicsee-mcp-server 'https://mcp.vicsee.com'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "vicsee-mcp-server": {
            "type": "http",
            "url": "https://mcp.vicsee.com"
        }
    }
}
NPM package @vicsee/mcp-server
Claude Code 
claude mcp add vicsee-mcp-server -e 'VICSEE_API_KEY=<your vicsee_api_key>' -- npx -y @vicsee/mcp-server@0.3.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "vicsee-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@vicsee/mcp-server@0.3.3"
            ],
            "env": {
                "VICSEE_API_KEY": "<your vicsee_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • VICSEE_API_KEY إلزامي سري VicSee API key (starts with sk-) from vicsee.com Settings then API. Requires a paid plan or credit pack.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. VicSee MCP Server
  2. What your agent can do
  3. Setup
  4. Local development
  5. Example agent flow
  6. Notes
  7. License

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

ToolWhat it does
vicsee_list_modelsList available models (Seedance, Veo, Kling, FLUX, Nano Banana, …) + their credit costs
vicsee_estimateSame arguments as vicsee_generate; returns the exact credits it will charge and creates nothing
vicsee_generateText/image → video or image with a chosen model
vicsee_get_taskPoll a task and get the finished media URL (result.expires_at — URLs are kept 7 days; download what you want to keep)
vicsee_upscale_imageUpscale an image
vicsee_upscale_videoUpscale a video
vicsee_get_creditsCheck 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

  1. Get an API key at vicsee.com → Settings → API (starts with sk-). API access requires a paid plan or credit pack.
  2. 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 to https://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."

  1. vicsee_list_models (type: video) → pick e.g. seedance-2-5-text-to-video (up to 30s) or seedance-2-0-text-to-video (adds 1080p/4K)
  2. vicsee_generate (model, prompt, duration: 5) → { id, status: "pending" }
  3. 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_models for per-model costs and vicsee_get_credits for your balance.

License

MIT

الأسئلة الشائعة

ما هو io.github.vicseeai/vicsee-mcp-server؟

Generate, edit and upscale AI video and images from any agent via VicSee.

كيف أثبّت io.github.vicseeai/vicsee-mcp-server؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http vicsee-mcp-server 'https://mcp.vicsee.com'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.vicseeai/vicsee-mcp-server إلى مفتاح API؟

نعم. يتطلب VICSEE_API_KEY، وتضبطها في إعداداته.

هل io.github.vicseeai/vicsee-mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.vicseeai/vicsee-mcp-server؟

ينشره vicseeai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.