arckep-blender-mcp
Local stdio Model Context Protocol (MCP) server connecting Blender 4.2 LTS – 5.x (via the ArcKep 3D Blender extension's loopback TCP bridge) with the ArcKep Public 3D API (/api/v1/models3d).
Licensed under MIT. Zero exec() of arbitrary Python code in Blender — all scene inspection, viewport rendering, asset import, and object placement run through typed loopback commands on 127.0.0.1.
Quick Start (uvx)
- Install the ArcKep 3D extension in Blender (
4.2+) and start the local bridge in 3D Viewport →N→ ArcKep 3D → MCP → Start MCP Bridge (default port9876). - Add
arckep-blender-mcpto your MCP client configuration (Claude Desktop, Cursor, Windsurf, Codex, Antigravity):
{
"mcpServers": {
"arckep-blender": {
"command": "uvx",
"args": ["arckep-blender-mcp"],
"env": {
"ARCKEP_API_KEY": "<YOUR_ARCKEP_KEY>",
"ARCKEP_BLENDER_PORT": "9876"
}
}
}
}
Required API key scopes: models3d:write and balance:read (local blender_* scene tools work even without ARCKEP_API_KEY).
Environment Variables
| Variable | Default | Description |
|---|---|---|
ARCKEP_API_KEY |
(empty) | ark_live_... token for /api/v1/* cloud calls (never logged or written to stdout). |
ARCKEP_API_BASE_URL |
Blender ping().api_base_url or https://arckep.ru/api/v1 |
Override /api/v1 base URL. |
ARCKEP_BLENDER_HOST |
127.0.0.1 |
Loopback address (127.0.0.1 or localhost only; non-local addresses raise ValueError). |
ARCKEP_BLENDER_PORT |
9876 |
TCP port of the Blender scene bridge (1024..65535). |
ARCKEP_BUDGET_MODE |
Live Blender preference or threshold |
threshold, confirm_always, or unlimited. |
ARCKEP_MAX_AUTO_COST_RUB |
Live Blender preference or 150.0 |
Auto-approve ceiling in RUB when ARCKEP_BUDGET_MODE=threshold. |
ARCKEP_POLL_INTERVAL_SEC |
1.5 |
Poll interval in seconds for /models3d/generations/{id} (>= 0.02). |
RUB Budget Guard (3 Modes)
Agents cannot change budget_mode or max_auto_cost_rub via tool arguments. Before every paid call (arckep_generate_3d, arckep_process_mesh), the server quotes the exact RUB price via /estimate:
threshold(default150.0₽) — jobs costing<= max_auto_cost_rubrun automatically; more expensive jobs returnstatus: "confirmation_required"(error_code: "CONFIRMATION_REQUIRED") without charging until the user confirms and the tool is re-called withconfirmed_max_cost_rub >= cost_rub.confirm_always— free (0₽) operations run immediately; any paid job (cost_rub > 0) stops withCONFIRMATION_REQUIREDuntil explicitly re-called withconfirmed_max_cost_rub >= cost_rub.unlimited— no local prompt cap (bounded only by account/corporate balance and optionalconfirmed_max_cost_rub).
Available MCP Tools (15)
Local Blender Scene Bridge (127.0.0.1)
blender_ping— bridge status, Blender/add-on versions, open.blend, and active Budget Guard policy.blender_get_scene_info— collections, objects, polygon counts, materials,arckep_job_idtags, 3D Cursor, and camera.blender_get_object_info— world bounding box, mesh/UV layers, armature bones, actions, modifiers, andarckep_job_id.blender_capture_viewport— rendercamera,selection, orsceneto PNG (512..2048px).blender_import_asset— import.glb,.fbx,.obj,.zip,.usdz,.stl,.ply,.3mf, or.splatat the 3D Cursor or[x, y, z].blender_transform_object— move, rotate (degrees), scale, and snap objects onto the ground plane (Z = 0).
ArcKep 3D Cloud, Post-Processing & 3D Print (/api/v1)
arckep_get_balance— personal or B2B corporate RUB balance + active Budget Guard settings.arckep_list_generations— paginated generation history or single job inspection (job_id).arckep_import_generation— download a completed archive job and import it into Blender witharckep_job_id.arckep_estimate_generation— free0₽ quote across all 9 creation models (rodin-v2.5,meshy-v7.1,tripo-h3.1,tripo-p2,tripo-p1,hunyuan-3d-3.1,tripo-multiview,tripo-splat,idol), including live Blender viewport blockout capture.arckep_generate_3d— full 3D / multiview generation with Budget Guard enforcement, polling, download, and scene import.arckep_check_rig— free0₽ skeleton compatibility check (rig-check) for a scene object, job ID, or local mesh.arckep_estimate_process— free0₽ quote across all 10 mesh operations (texture,decimate,uv,segment,smartsegment,complete,rig,retarget,rig_and_retarget,convert).arckep_process_mesh— run any of the 10 post-processing operations with Budget Guard enforcement and scene import (ArcKep_Parts_<id>grouping for segmentation/completion).arckep_export_print_stl— free0₽ slicer-ready binary.stlor.3mfexport in millimeters (target_size_mm,z_up,place_on_bed).
Metadata
Release files for arckep-blender-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| arckep_blender_mcp-0.1.0.tar.gz | 29.7 kB | With provenance | Details for arckep_blender_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| arckep_blender_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for arckep_blender_mcp-0.1.0-py3-none-any.whl |
Total release size: 60.4 kB
Release files / arckep_blender_mcp-0.1.0.tar.gz
| Download URL | arckep_blender_mcp-0.1.0.tar.gz |
|---|---|
| Size | 29.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2461f53006688f10c6117d115ac93b1009bbba0dcb5bd0c55756815e4df4196c
|
|
BLAKE2b-256 checksum How to use checksums |
c1a818e7a41cacebdaa4b39696052e7aef3c9177f6db2851ad4fc366a2dac95d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logRelease files / arckep_blender_mcp-0.1.0-py3-none-any.whl
| Download URL | arckep_blender_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 30.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0c26f542a27c184c778a369fb648d341b0c45e7eab5d8dadeabb189ca93f7737
|
|
BLAKE2b-256 checksum How to use checksums |
95f4d3a9be62385fa309a6f7fbfbe4a5be5731353b225951a517d2856ed522ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logSecurity for arckep-blender-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for arckep_blender_mcp-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.