独立仓库，捆绑所有模型上下文协议（MCP）服务器实现、自动化的CLI工具、代理技能、JSON-RPC模式以及来自ArtCraft生成媒体平台的伴随桥接路由。

该项目使AI编码助手（Claude Desktop、Windsurf、Cursor、Antigravity、OpenClaw）能够原生生成图像、视频、3D网格、高斯分布、TTS，并通过自然语言命令或自动脚本管理媒体资产。

---

📁 项目结构

---

⚡ 快速启动

1.一键设置（自动）

运行附带的配置脚本，自动检测并注册 artcraft-mcp]，跨 Claude 桌面、Windsurf 或光标：

2.手动配置

添加到你的MCP客户端配置文件中（例如，claude_desktop_config.json 或 ~/.codeium/windsurf/mcp_config.json）：

---

🔑 认证

服务器按以下顺序解析凭证：

1. ARTCRAFT_MCP_PRIVATE_SESSION_TOKEN：专用MCP会话承载令牌（mcp_session_private_...）。
2. ARTCRAFT_API_KEY：自动与POST /v1/mcp/session/create交换以进行活跃会话。

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)