Skip to main content
Glama
conversor3mf

conversor3mf

conversor3mf

testes

Print MakerWorld multicolor models on an Anycubic Kobra X without recoloring anything. Português · Español

Most multicolor 3MF files on MakerWorld are made for Bambu Lab printers. When you open one in Anycubic Slicer Next, the colors come in the file's filament order, not the order of the spools in your ACE. After syncing the ACE they end up swapped. Painted models are the worst case: the per-object color menu only shows one color, so you end up repainting by hand.

conversor3mf rewrites the project so that each color of the model goes to the ACE slot where that spool already is. It also includes an MCP server, so you can ask Claude to do it for you.

Not affiliated with Anycubic or Bambu Lab. All trademarks belong to their owners. Respect each model's license: the tool converts files you downloaded for your own use and never redistributes anything.

What it does

  • Remaps colors. Rewrites per-triangle paint, the filament of each part and per-layer filament changes to your ACE slot order. It picks the closest color (CIEDE2000) and merges identical colors.

  • Opens as a native Kobra X project. No "Printer parameter switching" dialog and no geometry-only import.

  • Keeps the designer's choices. Layer height, walls, infill, supports, brim, ironing and fuzzy skin carry over. Speeds and temperatures come from the Kobra X system profile.

  • Recenters plates. Objects on every plate are centered on the 260 mm Kobra X bed.

  • Warns you. It flags colors with no similar spool, more colors than ACE slots, and PLA/PETG mixes.

  • Recolors whole regions ("islands"). Turns all holly leaves green or all stars red, including the side walls of raised details, without touching the paint brush.

  • Tunes the purge for each color pair. The purge table (how much filament is flushed on each color change) is recalculated for the spools really in your ACE, and you can calibrate each pair: "white came out gray after black" → more purge only for black → white.

  • Never overwrites anything. It writes <name>_KobraX.3mf next to the original.

Related MCP server: bambu-studio-mcp

Requirements

  • Windows with Anycubic Slicer Next installed. It is detected automatically; if not, set CONVERSOR3MF_SLICER to its folder.

  • Python 3.10+.

  • An Anycubic Kobra X with ACE. Other Anycubic printers may work but are untested; see Limitations.

Tested with: Kobra X firmware 2.0.2.8 and Anycubic Slicer Next 2.0.0.3. If you use other versions and something behaves differently, please open an issue with your versions.

Install

pip install conversor3mf

Use with Claude (MCP)

claude mcp add conversor3mf --scope user -- conversor3mf-mcp

If you use uv, you can skip the pip install step: claude mcp add conversor3mf --scope user -- uvx --from conversor3mf conversor3mf-mcp

Claude Desktop (chat app): open Settings → Developer → Edit Config and add the server to claude_desktop_config.json, then restart the app:

{
  "mcpServers": {
    "conversor3mf": { "command": "python", "args": ["-m", "conversor3mf.servidor_mcp"] }
  }
}

Then just ask, in any language:

"Convert C:\Downloads\coaster.3mf for my Kobra X"

"I swapped slot 4 for a yellow PLA"

"In the coaster, make the holly leaves green and the stars red"

Claude shows where each color will go before converting. When recoloring, it looks at a numbered map of the model.

First-time setup: tell it what is in your ACE

  1. In Anycubic Slicer Next, select the Kobra X, sync the ACE and save any project.

  2. Run this command, or ask Claude to "set up my ACE from that project":

    conversor3mf ace setup "C:\path\to\saved_project.3mf"

This saves the printer profile and your slot colors and materials. When you only change a spool's color, update it like this:

conversor3mf ace slot 4 --color "#FFD700" --type PLA

For a material that is not in any slot yet (ABS, TPU…), save a new project with it and run ace setup again.

Your data lives in %APPDATA%\conversor3mf. Change it with CONVERSOR3MF_DADOS.

Step by step: talking to Claude

Write in your own language, the way you'd ask a friend. These are the prompts that work best, in the order you'll usually need them.

1. First time: show Claude your ACE

Sync the ACE in Anycubic Slicer Next, save any project, then:

"Set up my ACE using the project C:\Users\me\Documents\any_project.3mf"

Claude reads the slots and lists them back. Check that colors and materials match the spools you actually have loaded.

2. Whenever you swap a spool

"I swapped slot 4 for a yellow PLA"

"What's in my ACE right now?"

For a material that isn't in any slot yet (ABS, TPU…), repeat step 1 with a project that uses it.

3. Converting a file

Always give the full path of the file, or the folder plus the file name:

"Convert C:\Downloads\coaster.3mf for my Kobra X"

Claude first shows which slot each color goes to and warns about problems. Then:

  • If everything looks right: "go ahead".

  • If a color has no similar spool, you can swap the spool and tell Claude ("I loaded a green PLA in slot 4"), or force a slot: "put the orange (filament 3) in slot 3".

  • If the model has more colors than slots, tell it which ones to merge: "use the black slot for both the black and the dark gray".

4. Several files at once

"List the 3MF files in C:\Downloads and convert the ones made for Bambu printers"

5. Recoloring parts of a model ("islands")

Use the converted file (..._KobraX.3mf) and describe what and which color:

"In C:\Downloads\coaster_KobraX.3mf, make the holly leaves green and the stars red"

Claude draws a numbered map of every same-color region, picks the numbers and shows a preview of the result. Tips:

  • Describe the part by shape, position or current color: "the small white stars", "the leaves around the border", "the red dots on the hat".

  • For 3D figures, ask for another view: "look from the front" (or back, left, right, bottom).

  • If numbers are crowded, ask it to zoom: "zoom into the top-left corner".

  • Correct it with the numbers from the map: "not island 42, I meant 32".

  • Nothing is overwritten: each repaint creates a new ..._repintado.3mf file.

6. Checking before you print

"Check C:\Downloads\coaster_KobraX.3mf in the slicer"

For projects with more than one plate, also open the file in Anycubic Slicer Next and take a look (see Limitations).

7. Calibrating the purge (color bleeding or too much waste)

Each color change flushes some filament. Too little and the old color stains the new one; too much wastes filament. After a print, tell Claude what you saw:

"The white came out grayish right after the black"

"Show me how much each color change purges"

"I want to save filament, use the economy purge level"

Claude raises (or lowers) only that pair, by 20% each time, and remembers it for the next conversions. To apply it to a file you already converted: "apply the new purge to coaster_KobraX.3mf" (it writes ..._purga.3mf). Tip: "learn the purge from my projects in C:\Prints" teaches it the values Anycubic Slicer Next calculated for your colors.

What Claude can't do: start a print, change settings inside the slicer, or download models from MakerWorld. Download the 3MF yourself, then ask.

Command line

conversor3mf plan    model.3mf                    # show which slot each color goes to
conversor3mf convert model.3mf --map 1=3          # convert; force filament 1 into slot 3
conversor3mf islands model_KobraX.3mf --view top  # numbered map of color regions
conversor3mf repaint model_KobraX.3mf 32=4,3=3    # recolor islands 32 and 3
conversor3mf verify  model_KobraX.3mf             # reopen in Anycubic Slicer Next and compare

Every command and option also works in Portuguese and Spanish, so use whichever feels natural. Help and error messages follow the language you type in, or your system language:

English

Português

Español

inspect

inspecionar

inspeccionar

plan

planejar

planificar

convert

converter

convertir

verify

verificar

verificar

islands

ilhas

islas

repaint

repintar

repintar

ace show / setup / slot

ace mostrar / definir / slot

ace mostrar / configurar / ranura

--map --output --no-verify

--mapa --saida --sem-verificar

--mapa --salida --sin-verificar

--view top/bottom/front/back/left/right

--vista cima/baixo/frente/tras/esquerda/direita

--vista arriba/abajo/frente/atras/izquierda/derecha

--color --type --name

--cor --tipo --nome

--color --tipo --nombre

purge show / adjust 2 1 more / level economy / learn / apply

purga mostrar / ajustar 2 1 mais / nivel economia / aprender / aplicar

purga mostrar / ajustar 2 1 más / nivel economía / aprender / aplicar

Force a language with --language en (or pt, es) or the CONVERSOR3MF_IDIOMA variable. Run conversor3mf --help for the full list.

How it works

  • Color format. A Bambu/Orca 3MF stores filament numbers, not colors. The paint of each triangle is a hex-encoded subdivision tree with a filament number on every leaf. The converter decodes that tree, swaps the numbers and encodes it back. Every other part of the file is left untouched.

  • Printer settings. They come from a project saved by your own Anycubic Slicer Next, so no Anycubic profiles are shipped with this package.

  • Purge. The Kobra X firmware reads the purge table (flush_volumes_matrix) from the G-code header and flushes by itself; the real purge is table × flush_multiplier (0.7). Each pair uses the value Anycubic Slicer Next calculated for it in your saved projects, or the OrcaSlicer formula plus the nozzle volume, times your calibration.

  • Islands. Connected triangles of the same color, after welding duplicate vertices. When a triangle has several colors, recoloring only changes the leaves of that island's color, including on the island's border.

Limitations

  • Verification of multi-plate projects. Anycubic Slicer Next 2.0.0.3 crashes from the command line on any project with more than one plate. Those projects are only checked internally, so open them in the slicer before slicing.

  • Distance between plates in the slicer. Multi-plate projects are laid out side by side in the slicer, with a gap between plates. The bed itself is 260 × 260 mm; the distance from one plate to the next (314.4 mm sideways, 328.8 mm down) was measured from projects saved by Anycubic Slicer Next 2.0.0.3 for the Kobra X. Other printers fall back to 1.2 × the bed size, which is what Bambu Studio uses.

  • More colors than slots. Similar colors get merged. For multi-plate projects you can print plate by plate and use --map.

  • Mesh-only 3MF files. Files without a slicer project inside have no colors to convert.

Development

python -m venv .venv
.venv\Scripts\pip install -e .
.venv\Scripts\python -m unittest discover -s tests

The tests use synthetic 3MF files built in tests/fixtures.py and do not need the slicer. ferramentas/testar_na_interface.ps1 opens a file in the slicer GUI, takes a screenshot and closes it.

License

MIT

Available Tools

15 tools
ajustar_purgaA

Calibra a purga de uma troca de cor e guarda para as próximas conversões.

de/para: número do slot do ACE ("2") ou cor (#RRGGBB). de = cor que estava no bico, para = cor que entra (a que saiu manchada). mudanca: "mais" (+20%), "menos" (-20%) ou um fator (ex.: "1.5"). Para valer num arquivo já convertido, chame aplicar_purga depois.

Inputs: de (required), para (required), mudanca.

alterar_slot_aceB

Atualiza um slot do ACE depois que o usuário troca o carretel.

cor em hexadecimal (#RRGGBB); tipo precisa existir em algum slot do molde (ex.: PLA, PETG).

Inputs: slot (required), cor, nome, tipo.

aplicar_purgaB

Grava uma cópia do projeto (_purga.3mf) com a tabela de purga recalculada para as cores dele, usando a calibração salva. Nunca sobrescreve.

Inputs: arquivo (required), saida.

aprender_purgaC

Aprende a purga que o Anycubic Slicer Next calculou em projetos salvos por ele (pastas ou .3mf).

Inputs: pastas_ou_arquivos (required).

converter_3mfA

Grava o projeto convertido para a Kobra X (padrão: _KobraX.3mf ao lado do original) e confere no slicer.

mapa funciona como em planejar_conversao. Nunca sobrescreve arquivos existentes.

Inputs: arquivo (required), mapa, saida.

definir_molde_aceB

Usa um projeto salvo pelo Anycubic Slicer Next, com o ACE sincronizado, como molde.

Isso define impressora, perfis de filamento e a ordem real dos carretéis. Use quando o usuário trocar o tipo de material de algum slot ou na primeira configuração.

Inputs: projeto_3mf (required).

inspecionar_3mfB

Mostra impressora original, placas e cada filamento do projeto: cor, tipo e onde é usado.

Inputs: arquivo (required).

listar_3mfB

Lista os arquivos .3mf de uma pasta com tamanho e data, do mais novo para o mais antigo.

Inputs: pasta (required). Returns: result

mapa_de_ilhasA

Desenha o objeto com as cores reais e o número de cada ilha (região contínua de mesma cor).

vista: cima, baixo, frente, tras, esquerda ou direita (também em inglês: top, bottom, front, back, left, right; ou espanhol: arriba, abajo, frente, atras, izquierda, derecha). objeto: id do objeto (padrão: o maior; a resposta lista os outros). regiao: zoom [x0, y0, x1, y1] em mm nas coordenadas da vista (as mesmas de centro_mm na vista de cima: x e y; nas vistas laterais o eixo vertical é z). numeros=False desenha só a prévia, sem números. Devolve a imagem e a lista das ilhas rotuladas (slot, cor, tamanho, centro, altura do topo).

Inputs: arquivo (required), vista, objeto, regiao, +1 more.

nivel_purgaC

Fator geral de purga: economia (0,85), normal (1,0), caprichado (1,25) ou um número.

Inputs: nivel (required).

planejar_conversaoA

Mostra em qual slot do ACE cada cor do modelo vai sair, sem gravar nada.

mapa força slots: {"numero do filamento no modelo": slot do ACE}, ex.: {"1": 3, "2": 1}. Filamentos fora do mapa são escolhidos automaticamente pela cor mais parecida.

Inputs: arquivo (required), mapa.

repintar_ilhasA

Grava um 3MF novo com as ilhas escolhidas em outro slot e devolve uma prévia.

mudancas: {"número da ilha": slot}, ex.: {"32": 4, "3": 3}. Use os números de mapa_de_ilhas do mesmo arquivo e objeto. Ilha inteira muda (topo e laterais); em triângulos com várias cores só a parte da cor da ilha muda. Padrão de saída: _repintado.3mf; nunca sobrescreve.

Inputs: arquivo (required), mudancas (required), saida, objeto.

ver_aceA

Mostra os slots do ACE (cor, tipo e nome de cada carretel) e de qual projeto o molde foi tirado.

Inputs: no named parameters.

verificar_3mfC

Abre o arquivo no Anycubic Slicer Next pela linha de comando e confere impressora, cores e pintura.

Inputs: arquivo (required).

ver_purgaB

Mostra quanto filamento cada troca de cor do ACE purga (mm³ e gramas) e os ajustes salvos.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 15 tools

    Disambiguation4/5

    Most tools target a distinct resource+action, and the plan/write pairs (planejar_conversao vs converter_3mf, repintar_ilhas) are explicitly framed as dry-run vs. persist. The main soft overlaps are inspecionar_3mf vs verificar_3mf (report contents vs. open in slicer) and the purge trio (ver/ajustar/nivel/aprender), but descriptions make the boundaries clear enough to choose correctly.

    Naming Consistency4/5

    Nearly all names follow a Portuguese verb_noun pattern (ver_ace, listar_3mf, converter_3mf, aplicar_purga) with sensible suffixes grouping the ACE and purge families. Two names break the verb pattern by being bare nouns (mapa_de_ilhas, nivel_purga), a minor but noticeable deviation.

    Tool Count5/5

    15 tools sits at the top of the well-scoped range and each one maps to a concrete step in the workflow: file discovery, mold/slot setup, inspection, planning, conversion, island repaint, purge calibration, and verification. No tool looks redundant or purely decorative.

    Completeness4/5

    The conversion lifecycle is well covered end to end: list → inspect → set mold/slots → plan → convert → repaint → purge calibrate/apply → verify. Minor gaps remain, such as no way to remove or reset a saved per-transition purge calibration, and no explicit slot-clearing/reset operation.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables comprehensive control and monitoring of Bambu Lab 3D printers through Claude using local MQTT, FTPS, and X.509 authentication. Users can manage print jobs, monitor real-time status, handle filament through AMS, and adjust hardware settings like temperature and lighting.
      24
      24
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Integrates Bambu Studio and Bambu Lab 3D printers with Claude, enabling printer status checks, print control, file management, and slicing via natural language.
      9
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to model 3D-printable parts by running Python scripts in a headless FreeCAD instance and exporting STL/3MF/STEP files. It also lets Claude visually inspect renders, check mesh integrity and overhang printability, measure volume and estimated mass, and open results in a slicer before printing.
      10
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude to analyze STL/3MF models, slice them with the real Bambu Studio engine, compare print recipes by time and weight, and manage presets for Bambu Lab printers. It produces ready-to-print .3mf project files with material and build-plate settings applied, all locally on the user's PC.
      18
      3
      MIT