Skip to main content

JustThreed — control Blender with natural language

License Sponsor

JustThreed is a Python MCP server that exposes Blender control tools to any Model Context Protocol (MCP) compatible AI client — Claude Desktop, Claude Code, Gemini CLI, Cursor, VSCode, Ollama, and more. Describe what you want in plain English and watch Blender build it:

"Create a low poly cabin in the woods with warm lighting"
"Add a stone texture to the ground plane"
"Render the scene from a top-down angle"

This package is the AI-client-side half of JustThreed. The other half is a Blender addon that opens a TCP socket on localhost:9876 and executes the tool calls against the bpy API. You need both pieces installed for anything to work — see the full setup guide in the repository.

Quick install

Assuming the Blender addon is already installed and its MCP socket server is running on port 9876, add JustThreed to your AI client's MCP config:

{
  "mcpServers": {
    "justthreed": {
      "command": "uvx",
      "args": ["justthreed"]
    }
  }
}

Or, for Claude Code:

claude mcp add --scope user justthreed -- uvx justthreed

For per-client setup (Claude Desktop, Gemini CLI, Cursor, Ollama, OpenRouter) and the Blender addon install steps, see the main README on GitHub.

How it works

AI Client (Claude / Gemini / Cursor / Ollama / ...)
       ↓
JustThreed MCP Server (this package)  — translates intent to commands
       ↓
JustThreed Blender addon — socket server on port 9876
       ↓
Blender (bpy API) — executes in real time

Development

Run against the MCP Inspector (requires the Blender extension running with the MCP Server started):

uv run --with 'mcp[cli]' mcp dev src/justthreed/server.py

Run the server directly (stdio transport — what Claude Desktop does):

uv run justthreed

License

MIT — see LICENSE.

Metadata

Release files for justthreed 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for justthreed 0.1.0
File Size Uploaded Provenance Actions
justthreed-0.1.0.tar.gz 57.7 kB Without provenance Details for justthreed-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for justthreed 0.1.0
File Interpreter ABI Platform Actions
justthreed-0.1.0-py3-none-any.whl Python 3 none any Details for justthreed-0.1.0-py3-none-any.whl

Total release size: 76.3 kB

Release files / justthreed-0.1.0.tar.gz

Download URL justthreed-0.1.0.tar.gz
Size 57.7 kB
Tags Source
SHA-256 checksum
How to use checksums
bdf55dbe030c19c7c96ea808149fd0d5f9214d30699531b16b4b7eaa90c8c6ca
BLAKE2b-256 checksum
How to use checksums
cf69e43d39d906e8cd988b8254151d93e964377239b404108025724fdf503632
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / justthreed-0.1.0-py3-none-any.whl

Download URL justthreed-0.1.0-py3-none-any.whl
Size 18.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b9cc030595297824ad91dd015ee9836c4cde06734ea34dd5b5c8550f643ab5d0
BLAKE2b-256 checksum
How to use checksums
b4929c497706c3be6d75a963fc99be9d1e71e7afb5a5a4ea9ab4a02171be5c39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for justthreed 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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A 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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page