connecter-mcp
Integrates with Autodesk 3ds Max by generating MAXScript that can be returned for the user to run in an open session or executed headlessly via 3dsmaxbatch.exe. Enables measuring and fixing models, creating V-Ray/Corona proxies, converting renderers (Corona <-> V-Ray) and file versions, managing materials and .mat libraries, merging assets into scenes, swapping placeholders, furnishing rooms, verifying and relinking textures inside .max files, and exporting scenes back to the library.
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.
connecter-mcp
An MCP server for Connecter, Design Connected's asset manager for 3D artists. Its 95 tools let Claude (or any MCP client) search, tag, catalogue, ingest, audit and repair your Connecter library while Connecter keeps running. It can also fix and convert models with 3ds Max, assemble scenes, search the library by what models look like, produce FF&E schedules and client boards, and keep the library tidy automatically.
Unofficial. Not affiliated with or endorsed by Design Connected. It uses the same local integration channels Connecter's own 3ds Max, Blender and Maya plugins use. No Connecter code is included.
What it can do
Area | Tools |
System |
|
Assets |
|
Tags |
|
Files & folders |
|
Ingestion |
|
Health |
|
Missing assets |
|
Textures |
|
Library upkeep |
|
Textures in .max files |
|
Models (3ds Max) |
|
Materials (3ds Max) |
|
Scenes (3ds Max) |
|
AI cataloguing |
|
Visual search |
|
Projects & output |
|
Automation |
|
Safety |
|
Every change is written to a journal (~/.connecter-mcp/journal.jsonl) with the API calls that reverse it, so undo can roll it back. Files changed on disk (relinked .max files, resized textures, material libraries) are backed up first and undo copies them back. Tools that move files or touch many assets default to dry_run=True and return a plan first.
Related MCP server: workspace-mcp
Working with 3ds Max
Tools that only read a .max (verify_textures, scene_missing_assets, scene_asset_report, list_materials, extract_metadata, consistency_check in file mode) read the file directly: no 3ds Max needed. Thumbnails, scene totals, materials, plug-ins and every referenced file are stored inside each .max.
The others build MAXScript and run it one of two ways:
mode="script": nothing is started. The tool returns the script, which you run in your open 3ds Max (for example with a 3ds Max MCP'sexecute_maxscript). Scene tools (merge_into_max,furnish_room, ...) always work this way. Scripts that open another file refuse to run over unsaved changes.mode="batch": the script runs headless in3dsmaxbatch.exeat below-normal priority. It refuses to start while 3ds Max is busy (more thanmax_busy_cpu, e.g. while rendering) or memory is low, unless you passforce=True.
Renderer conversion uses the converters that ship with Corona (coronaConverter.ms) and V-Ray (vrayutils.ms).
Visual search
build_index gives each model a visual fingerprint from its first preview, or from the thumbnail inside its .max. backend="clip" understands content and text queries. It runs CLIP in a separate Python process through uv at idle priority, so it never competes with a render. The first run downloads the model (about 350 MB). backend="basic" needs nothing extra but only compares colour and layout. Indexing runs as a background job (jobs).
How it talks to Connecter
JSON over TCP. A running Connecter listens on a local port (stored in the registry under
HKCU\Software\Design Connected\Connecter\Integration\JsonMessagingTcpPort). Each request is one JSON object on its own connection, with aResponseEndpointthat Connecter connects back to with the reply.Message folder. JSON files dropped into Connecter's
integrationBufferfolder catalogue assets with tags and previews. This is the same mechanism its DCC plugins use.Read-only database snapshots for fast library-wide searches and audits. The live
default.dcdbis copied first and never written to.
Requirements
Windows, with Connecter 8.x installed and running
uv (installs Python 3.11+ and the dependencies automatically)
Optional: 3ds Max 2021+ for the 3ds Max tools (tested with 2024, Corona and V-Ray installed)
Install
git clone https://github.com/SHUBHAM3601/connecter-mcp.gitRegister it with Claude Code:
claude mcp add connecter --scope user -- uv --directory "C:\path\to\connecter-mcp" run connecter-mcpOr add it to any MCP client's config:
{
"mcpServers": {
"connecter": {
"command": "uv",
"args": ["--directory", "C:\\path\\to\\connecter-mcp", "run", "connecter-mcp"]
}
}
}Configure (optional)
Create %USERPROFILE%\.connecter-mcp\config.toml. See config.example.toml:
# Folder whose sub-folders are your library categories (enables ingest_model and library_categories)
models_dir = 'D:\Library\3D MODELS'
# Extra places to search for moved assets and missing textures
search_dirs = ['E:\Old Library']
# Folder Connecter is normally started from (used by restart_connecter)
launch_dir = 'C:\Users\you\Documents\Design Connected\Connecter\Sample Products'
# 3ds Max for headless jobs (default: newest installed) and how busy it may be before they wait
max_dir = 'C:\Program Files\Autodesk\3ds Max 2024'
max_busy_cpu = 150Examples
"Move
Downloads\Pro 3DSky - Pebble River Collectioninto the library under 09_MISC and tag it." →inspect_folder, theningest_model(dry run, then real)"Which models have no tags?" →
search_assets(untagged=True, extension=".max")"Some assets show as missing in Connecter, fix them." →
batch_relocate(dry run, then real)"Why does this model render without its normal map?" →
scan_textures,find_texture_candidates,localize_textures"Make a LANDSCAPE tag under 09_MISC and move the pebbles into it." →
create_tag,tag_assets,untag_assets"Find me a round travertine coffee table." →
semantic_search"Swap the PH_SOFA boxes for this Minotti sofa." →
swap_placeholder, then run the script in 3ds Max"Make an FF&E schedule of everything this scene uses." →
ffe_schedule(scene=...)"File new sofa downloads under 02_FURNITURES/SOFAS automatically." →
rules(action="add", ...),guardian(action="start", auto_fix=True)
Testing
tests/live_test.py exercises every tool through the MCP layer against a running Connecter. It works on a throwaway copy of one model in <models_dir>/<category>/_MCP_TEST and removes it afterwards:
uv run python tests/live_test.py "D:\Library\3D MODELS\09_MISC\Some Model"tests/extended_test.py covers the 3ds Max, AI, project and automation tools the same way. It never starts 3ds Max: the 3ds Max tools are checked in script mode, and batch mode only to confirm it is refused while 3ds Max is busy. Add --clip to test CLIP search too.
uv run python tests/extended_test.py "D:\Library\3D MODELS\09_MISC\Some Model" --clipConnecter behaviours worth knowing
One tag per branch. An asset can't hold a tag and its own parent or child tag. Tagging with one replaces the other, and
tag_assetsreports how many it replaced (andundoputs them back). Sibling tags and tags in other branches can be combined freely.Tag colours must come from Connecter's palette:
cyan,purple,lavender,yellow,pink,white.Renaming assets. Connecter 8.0's own rename drops the file extension, so
rename_assetrenames on disk and re-points the catalogue entry instead.Custom properties and versions are only available in some Connecter workspaces; on others these tools say so.
Hiding files. There is no hide command in Connecter's API, so
hide_filesuses the hiding Connecter applies to previews. Files can only be unhidden in Connecter itself (right-click > Unhide).Removing previews by path is rejected by Connecter ("invalid asset paths"), so the tools look up each preview's GUID first.
Notes
Built against Connecter 8.0. Integration commands are discovered from Connecter's public plugin behaviour; a Connecter update can change them. Run
connecter_statusafter updating.restart_connecterstarts Connecter from the same working folder as its Start-menu shortcut. Starting it from elsewhere makes its 3ds Max integration check fail.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Hosted remote MCP for protected account access, permissions, activity history and supported undo.
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Manage SRG+ hubs, channels, content, assets, users, and workspaces from any MCP-aware AI agent.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server providing tools for the Iconik media asset management API. Supports assets, collections, search, metadata, jobs, users, groups, and more with dual transport (SSE and HTTP) and Docker support.1-
- AlicenseAqualityBmaintenanceEnables MCP clients to safely read, write, edit, search, and optionally run commands within one or more named project workspaces, while maintaining a work journal and tracking changes.19MIT
- AlicenseNot gradedqualityBmaintenanceProvides a local creator asset library MCP server that scans folders to catalog media files, batch-renames them, applies tags, tracks asset lineage between source and finished works, and offers keyword- and BGE-vector-based semantic search. It also lets other content-production MCP servers auto-register their generated outputs into the library for later retrieval and reuse.MIT
- AlicenseNot gradedqualityBmaintenanceEnables users to query and manage Kitsu/Zou production data, including projects, shots, assets, tasks, people, previews, video review, and optional write actions, through an MCP interface. Supports local stdio use and hosted HTTP connectors with per-user Kitsu authentication and read-only defaults.64 PyPI1MIT