ArtCraft MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ArtCraft MCP Server & Automation Suite
Standalone repository bundling all Model Context Protocol (MCP) server implementations, automation CLI tools, agent skills, JSON-RPC schemas, and companion bridge routes from the ArtCraft generative media platform.
This project enables AI coding assistants (Claude Desktop, Windsurf, Cursor, Antigravity, OpenClaw) to natively generate images, videos, 3D meshes, Gaussian splats, TTS, and manage media assets through natural language commands or automated scripts.
π Project Structure
artcraft-mcp/
βββ bin/ # Standalone, ready-to-run 64-bit Windows binary
β βββ artcraft-mcp.exe # Full 61-tool ArtCraft MCP server
β
βββ rust/ # Rust Source Implementation
β βββ README.md # Architecture & crate guide
β βββ artcraft_mcp_cli/ # Full 61-tool MCP server crate
β βββ Cargo.toml
β βββ README.md
β βββ src/
β βββ main.rs, server.rs, auth.rs, client.rs, types.rs
β βββ tools/ # 15 tool modules (image, video, 3D, voice, jobs...)
β
βββ tools/ # Standalone Python Automation CLI Suite
β βββ artcraft_runner.py # Batch video & image generator with async polling
β βββ artcraft_3d_runner.py # Hunyuan 3D & WorldLabs Marble Splat pipeline
β βββ artcraft_angle_matrix.py # 4-quadrant camera orbit generator (flux_2_lora_angles)
β βββ artcraft_audio_weaver.py # Audio stem reference & voice synthesis weaver
β βββ artcraft_cost_estimator.py # Live credit balance inspector & cost estimator
β
βββ skills/ # AI Agent Skills & Knowledge References
β βββ artcraft-mcp/
β β βββ SKILL.md # Main agent instruction skill
β β βββ references/ # Model matrices, aspect ratios & specs
β β βββ aspect-ratios.md
β β βββ image-models.md
β β βββ video-models.md
β β βββ three_d_and_splat_models.md
β βββ open-source-contributor/
β βββ SKILL.md # Open source contributor workflows & checklist
β
βββ companion/ # Desktop App & API Companion Integration
β βββ mcp_routes.py # FastAPI / FastMCP lifecycle routes (start, stop, health, token)
β βββ docs_mcp_server.md # Architecture & companion integration guide
β
βββ schemas/ # Complete JSON-RPC tool definitions (61 tools)
β βββ artcraft_generate_image.json
β βββ artcraft_generate_video.json
β βββ artcraft_generate_3d_object.json
β βββ artcraft_generate_audio.json
β βββ artcraft_download_media_file.json
β βββ artcraft_estimate_splat_cost.json
β βββ ... (55 more schemas)
β
βββ ArtCraft-MCP-Setup-Guide.md # Full client setup guide (Claude, Windsurf, Cursor)
βββ TOOLS.md # Comprehensive CLI documentation
βββ DEV-NOTES.md # Development notes & architecture
βββ CHANGELOG.md # Release history
βββ CONTRIBUTING.md # Contribution guidelines
βββ CODE_OF_CONDUCT.md # Code of conduct
βββ SECURITY.md # Security policies
βββ PULL_REQUEST_TEMPLATE.md # Pull request template
βββ LICENSE.md # License terms
βββ setup_mcp.py # 1-Click MCP client configuration utilityRelated MCP server: MoviePy MCP Server
β‘ Quick Start
1. One-Click Setup (Automatic)
Run the included configuration script to auto-detect and register artcraft-mcp across Claude Desktop, Windsurf, or Cursor:
python setup_mcp.py2. Manual Configuration
Add to your MCP client configuration file (e.g., claude_desktop_config.json or ~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"artcraft": {
"command": "C:\\path\\to\\artcraft-mcp\\bin\\artcraft-mcp.exe",
"args": [],
"description": "ArtCraft AI generative media platform (Full 61-tool engine)"
}
}
}π Authentication
The server resolves credentials in the following order:
ARTCRAFT_MCP_PRIVATE_SESSION_TOKEN: Dedicated MCP session Bearer token (mcp_session_private_...).ARTCRAFT_API_KEY: Automatically exchanged withPOST /v1/mcp/session/createfor an active session.ARTCRAFT_SESSIONandARTCRAFT_AVT: Session cookie environment variables.Credential Files: Auto-detected from
~/Artcraft/credentials/:artcraft_session.txtβ Your session cookieartcraft_avt.txtβ Your visitor cookie
ArtCraft Desktop App Store: Auto-detected from
%LOCALAPPDATA%\ai.artcraft.app\.cookies.
π οΈ CLI Automation Suite
All scripts in tools/ communicate directly with bin/artcraft-mcp-server.exe over stdio JSON-RPC without needing external servers:
Check Credits & Generation Costs
python tools/artcraft_cost_estimator.py --check-balance --video-model seedance_2p0 --duration 5Batch Image & Video Generation
python tools/artcraft_runner.py `
--prompt "Cinematic cyberpunk alleyway at dusk, anamorphic lens, neon reflections" `
--model flux_1_dev `
--copies 2 `
--out-dir "./outputs"Hunyuan 3D Mesh & Gaussian Splat Generation
python tools/artcraft_3d_runner.py `
--image "path/to/character.png" `
--mode both `
--out-dir "./outputs/3d"4-Quadrant Camera Orbit Pass
python tools/artcraft_angle_matrix.py `
--image "path/to/subject.png" `
--prompt "Maintain facial details during camera orbit" `
--out-dir "./outputs/orbit"π€ AI Agent Skills
Agent skills and prompt guidance are provided in skills/artcraft-mcp/:
SKILL.md: Behavioral instructions, parameter schemas, and error handling for LLM agents.references/: Model capability tables, aspect ratio rules, and duration limits for:Image: Flux 1 Dev/Schnell, Flux Pro 1.1 Ultra, Nano Banana Pro, Seedream 4/4.5/5, Midjourney 7/8.
Video: Kling (3.0/2.6/2.1), Veo (3/3.1), Seedance (2.0/1.5), Sora 2, Grok Imagine Video.
3D & Splat: Hunyuan 3D 2.0/2.1, WorldLabs Marble Gaussian Splatting.
π₯οΈ Companion API Bridge
For applications integrating the MCP server as a managed subprocess, companion/mcp_routes.py provides FastAPI endpoints:
GET /api/mcp/healthβ Check process state and PID.POST /api/mcp/startβ Spawn the binary with stdio pipes.POST /api/mcp/stopβ Gracefully terminate or kill the process.POST /api/mcp/tokenβ Exchange API keys/cookies for an MCP session token.
π Documentation
Setup Guide β Comprehensive client installation manual.
CLI Tools Guide β Detailed parameters for all Python tools.
Developer Notes β Architecture and protocol details.
Rust Source Guide β Source code walkthrough for both crates.
Companion Guide β FastAPI / FastMCP bridge architecture.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Generate images, video, music and voice from your CLI or AI agent. On-brand AI media toolkit.
Turn any LLM multimodal; generate images, voices, videos, 3D models, music, and more.
Generate and edit images, video, voice, lip-sync and 3D models from your AI agent.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides AI-powered media generation tools including image, speech, video, OCR, and voice conversion via the Model Context Protocol.MIT
- FlicenseCqualityCmaintenanceEnables AI agents to perform video editing, procedural animation, audio processing, overlays, and custom animation through natural language via the Model Context Protocol.42-
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents to generate cinematic video and image assets and perform autonomous timeline assembly, multi-track audio editing, chroma-key compositing, and local draft manipulation from conversational prompts.3MIT
- AlicenseBqualityCmaintenanceEnables any MCP-compatible AI agent to generate videos and images from text or reference frames, chain scenes into seamless multi-scene films with sound and speech, and download finished media with manifests and previews. It also exposes account status, plan limits, history and library management through confirm-gated, safe-by-default operations.2634MIT