orcaslicer-mcp

Let an AI assistant like Claude work with OrcaSlicer and your OrcaSlicer code.

What is this? (plain version)

Claude and other AI assistants can only talk by default. An MCP server is a small helper program that gives them new abilities — like hands and eyes for a job.

This helper gives the AI two sets of abilities:

1. Work with your code. Look at your OrcaSlicer code, check what changed, read files, search the code, and check if your online tests passed.

2. Work with the slicer. Slice a 3D model into a print file, then read back how long it will take, how much filament it uses, and how many layers it has.

So instead of you clicking around, you can just ask: "Slice the Julia vase and tell me how long it takes," or "What changed in my code today?"

MCP stands for Model Context Protocol. It's just the name for the standard way AI apps plug into helper programs like this one.

What you need first

You need these installed on your Windows PC. Each one is free.

How to install (step by step)

1. Download this helper

Open a terminal and run:

git clone https://github.com/Diterex/orcaslicer-mcp.git
cd orcaslicer-mcp

2. Install the one Python package it needs

python -m pip install "mcp[cli]"

3. Find the full path to your Python

You'll need this in the next step. On Windows, run:

where python

Copy the first line it prints. It looks something like C:\Users\YOU\AppData\Local\Programs\Python\Python310\python.exe.

4. Tell your AI app about this helper

You add a few lines to your AI app's settings file. Below is the pattern. Replace the two paths with your paths (your Python from step 3, and the folder where you downloaded this helper).

"orcaslicer-mcp": {
  "type": "stdio",
  "command": "C:\\Path\\To\\python.exe",
  "args": ["C:\\Path\\To\\orcaslicer-mcp\\server.py"],
  "env": {}
}

Where does that go?

• Claude Desktop: in claude_desktop_config.json, inside the mcpServers section.

• Claude Code: in .claude.json, inside the mcpServers section. Or, easier, run this one command (put your real paths in):

  claude mcp add --scope user orcaslicer-mcp -- "C:\Path\To\python.exe" "C:\Path\To\orcaslicer-mcp\server.py"

Tip: use double backslashes (\\) in the JSON file, like the example shows.

5. Restart your AI app

Close it fully and open it again. That's it — the new abilities are ready.

How to use it

Just talk to your AI normally. Here are things you can try:

• "What branch am I on and what's changed?"

• "Show me my last 5 commits."

• "Did my latest tests pass on GitHub?"

• "List the test models I can slice."

• "Slice the Julia vase model and tell me the print time and filament weight."

• "Read the print file we just made and summarize it."

The AI picks the right ability for what you asked.

Settings you can change (optional)

Good news: it finds most things by itself. It looks for OrcaSlicer in the usual places (and on your system PATH), and it finds your code folder if you run it from inside your OrcaSlicer folder. So for slicing, you usually don't set anything.

One thing to set for the code tools: if you want the "work with your code" tools (git, GitHub), point it at your OrcaSlicer folder with ORCA_FORK_DIR. That's the only setting most people need.

You set any of these inside the "env" part of the config from step 4:

Example (inside "env": { ... }):

"env": {
  "ORCA_FORK_DIR": "C:\\Users\\YOU\\code\\OrcaSlicer",
  "ORCA_SLICER_EXE": "D:\\Programs\\OrcaSlicer\\orca-slicer.exe"
}

Is it safe?

Yes, by design. Some abilities can change things — like saving a commit, sending code to GitHub, or opening a pull request. Those never happen on their own.

The AI first shows you exactly what it would do and does nothing. It only goes through if you clearly say yes (the tool needs a confirm flag turned on). So the AI can't quietly push your code or open a request without you agreeing.

Also good to know: this helper runs on your computer with your permissions, the same as any program you start. Only install helpers you trust.

A few things it does to stay safe:

• Stays in bounds. Reading files, slicing, and reading print files are all limited to your OrcaSlicer folder, your model folder, and its output folder. It won't read or overwrite files elsewhere on your PC.

• No sneaky flags. Values you pass (branch names, search text, file paths) can't be turned into hidden command options.

• Point it at code you trust. For the code tools, set ORCA_FORK_DIR to your own OrcaSlicer folder rather than running it inside a folder you downloaded from someone else.

The full list of abilities (tools)

Work with your code

Work with the slicer

Works alongside OrcaSlicer's built-in helper

OrcaSlicer is adding its own built-in MCP helper (PR #12667) that controls the app while it's open — screenshots, the 3D view, live settings. That one and this one work well together:

• This helper works with your code and can slice without opening the app.

• The built-in one controls the open app (screenshots and the 3D view).

You can turn on both.

License

MIT — free to use, change, and share. See LICENSE.