bambu-printer-mcp 1.1.66 → 1.1.67
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +39 -5
- package/dist/counterpart/remote.js +4 -0
- package/dist/design-app-setup.d.ts +384 -0
- package/dist/design-app-setup.js +654 -0
- package/dist/fusion-mcp-bridge.d.ts +11 -2
- package/dist/fusion-mcp-bridge.js +9 -4
- package/dist/index.js +44 -2
- package/dist/tool-annotations.js +4 -0
- package/package.json +1 -1
- package/src/counterpart/remote.ts +4 -0
- package/src/design-app-setup.ts +640 -0
- package/src/fusion-mcp-bridge.ts +9 -4
- package/src/index.ts +44 -2
- package/src/tool-annotations.ts +4 -0
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
import { type CallToolResult } from "@modelcontextprotocol/sdk/types.js";
|
|
2
|
-
/**
|
|
3
|
-
|
|
2
|
+
/**
|
|
3
|
+
* The server and add-in commit fusion_mcp_setup installs (FUSION_ADDIN_COMMIT): David Montgomery's fork of
|
|
4
|
+
* faust-machines/fusion360-mcp-server with document binding, which fusion_mcp_new_design's bind_document needs, while
|
|
5
|
+
* that change is reviewed upstream. Move it only after the Counterpart PRD §8.9 acceptance check passes.
|
|
6
|
+
*/
|
|
7
|
+
export declare const FUSION_MCP_PIN: string;
|
|
4
8
|
/** PRD §8.9: Blender's MCP add-on holds the add-in's own default, 9876, so Counterpart's Fusion uses 9877. */
|
|
5
9
|
export declare const FUSION_ADDIN_DEFAULT_PORT = 9877;
|
|
6
10
|
export declare const FUSION_MCP_DEFAULT_ARGS: readonly string[];
|
|
@@ -25,6 +29,11 @@ export type FusionSystem = {
|
|
|
25
29
|
*/
|
|
26
30
|
export declare function fusionLaunchArguments(port: number): string[];
|
|
27
31
|
export declare const defaultFusionSystem: FusionSystem;
|
|
32
|
+
/** Where the add-in listens: faust reads FUSION_MCP_HOST and FUSION_MCP_PORT too. */
|
|
33
|
+
export declare function addinAddress(): {
|
|
34
|
+
host: string;
|
|
35
|
+
port: number;
|
|
36
|
+
};
|
|
28
37
|
export declare const FUSION_STATUS_OUTPUT_SCHEMA: {
|
|
29
38
|
type: "object";
|
|
30
39
|
properties: {
|
|
@@ -20,13 +20,18 @@ import net from "node:net";
|
|
|
20
20
|
import path from "node:path";
|
|
21
21
|
import { promisify } from "node:util";
|
|
22
22
|
import { stlMetadata } from "./blender-mcp-bridge.js";
|
|
23
|
+
import { FUSION_ADDIN_COMMIT, FUSION_ADDIN_REPOSITORY } from "./design-app-setup.js";
|
|
23
24
|
const execFileAsync = promisify(execFile);
|
|
24
|
-
/**
|
|
25
|
-
|
|
25
|
+
/**
|
|
26
|
+
* The server and add-in commit fusion_mcp_setup installs (FUSION_ADDIN_COMMIT): David Montgomery's fork of
|
|
27
|
+
* faust-machines/fusion360-mcp-server with document binding, which fusion_mcp_new_design's bind_document needs, while
|
|
28
|
+
* that change is reviewed upstream. Move it only after the Counterpart PRD §8.9 acceptance check passes.
|
|
29
|
+
*/
|
|
30
|
+
export const FUSION_MCP_PIN = FUSION_ADDIN_COMMIT.slice(0, 12);
|
|
26
31
|
/** PRD §8.9: Blender's MCP add-on holds the add-in's own default, 9876, so Counterpart's Fusion uses 9877. */
|
|
27
32
|
export const FUSION_ADDIN_DEFAULT_PORT = 9877;
|
|
28
33
|
export const FUSION_MCP_DEFAULT_ARGS = Object.freeze([
|
|
29
|
-
"--from", `git+https://github.com
|
|
34
|
+
"--from", `git+https://github.com/${FUSION_ADDIN_REPOSITORY}@${FUSION_MCP_PIN}`,
|
|
30
35
|
"fusion360-mcp-server", "--mode", "socket",
|
|
31
36
|
]);
|
|
32
37
|
const DEFAULT_TIMEOUT_MS = 180000;
|
|
@@ -149,7 +154,7 @@ function configuration() {
|
|
|
149
154
|
return { command, args };
|
|
150
155
|
}
|
|
151
156
|
/** Where the add-in listens: faust reads FUSION_MCP_HOST and FUSION_MCP_PORT too. */
|
|
152
|
-
function addinAddress() {
|
|
157
|
+
export function addinAddress() {
|
|
153
158
|
const host = process.env.FUSION_MCP_HOST?.trim() || "localhost";
|
|
154
159
|
const port = Number(process.env.FUSION_MCP_PORT?.trim() || FUSION_ADDIN_DEFAULT_PORT);
|
|
155
160
|
return { host, port: Number.isInteger(port) && port > 0 && port < 65536 ? port : FUSION_ADDIN_DEFAULT_PORT };
|
package/dist/index.js
CHANGED
|
@@ -27,7 +27,8 @@ import { BambuNetworkBridge, describeBambuNetworkPrintError } from "./bambu-netw
|
|
|
27
27
|
import { assertBambuNativeAvailable, bambuNativeControlsAvailable, bambuNativeUnavailableReason, interruptNativeOperations, validateBambuNativeMetadata, buildBambuNativeFanCommand, buildBambuNativeTemperatureCommand, printWithBambuNative, sendCommandWithBambuNative, uploadWithBambuNative, } from "./bambu-native.js";
|
|
28
28
|
import { importFileViaBambuConnect } from "./bambu-connect.js";
|
|
29
29
|
import { BlenderMcpBridge } from "./blender-mcp-bridge.js";
|
|
30
|
-
import { FUSION_EXPORT_OUTPUT_SCHEMA, FUSION_MCP_DEFAULT_ARGS, FUSION_NEW_DESIGN_OUTPUT_SCHEMA, FUSION_STATUS_OUTPUT_SCHEMA, FusionMcpBridge } from "./fusion-mcp-bridge.js";
|
|
30
|
+
import { FUSION_EXPORT_OUTPUT_SCHEMA, FUSION_MCP_DEFAULT_ARGS, FUSION_MCP_PIN, FUSION_NEW_DESIGN_OUTPUT_SCHEMA, FUSION_STATUS_OUTPUT_SCHEMA, FusionMcpBridge, addinAddress } from "./fusion-mcp-bridge.js";
|
|
31
|
+
import { BLENDER_SETUP_OUTPUT_SCHEMA, BlenderAddonSetup, FUSION_ADDIN_REPOSITORY, FUSION_SETUP_OUTPUT_SCHEMA, FusionAddinSetup, defaultSetupSystem, parseAddonHandshake } from "./design-app-setup.js";
|
|
31
32
|
import { bridgeAmsMapping2Entry, bridgeAmsMappingValue, externalTrayForNozzle, hasAmsMappingInput, normalizeAmsMappingObject, normalizeBridgeAmsTrayValue, studioAmsMappingInfo, trayColour } from "./ams-mapping.js";
|
|
32
33
|
import { analyze3MFAmsRequirements, analyze3MFPlateObjects, analyzeCollarCharm3MF, extractBambuTemplateSettings, getCollarCharmRolePolicy, hasBambuProjectSettings, hasSlicerSettingsFile, parse3MF, withExtractedSettingsCleanup } from './3mf_parser.js';
|
|
33
34
|
import { BambuImplementation, assertDirectPrintSupported, checkedFile, defaultResumeStateDir } from "./printers/bambu.js";
|
|
@@ -1108,6 +1109,9 @@ class BambuPrinterMCPServer {
|
|
|
1108
1109
|
constructor() {
|
|
1109
1110
|
this.blender = new BlenderMcpBridge();
|
|
1110
1111
|
this.fusion = new FusionMcpBridge();
|
|
1112
|
+
// Downloads and installer output are staged in this server's own temporary folder.
|
|
1113
|
+
this.blenderSetup = new BlenderAddonSetup(() => this.blenderAddonHandshake(), { ...defaultSetupSystem, tmp: TEMP_DIR });
|
|
1114
|
+
this.fusionSetup = new FusionAddinSetup(() => addinAddress().port, FUSION_MCP_DEFAULT_ARGS, { ...defaultSetupSystem, tmp: TEMP_DIR });
|
|
1111
1115
|
this.shuttingDown = false;
|
|
1112
1116
|
this.confirmationTimeoutMs = parseConfirmationTimeout(process.env.BAMBU_CONFIRMATION_TIMEOUT_MS);
|
|
1113
1117
|
this.runtimeConfig = readRuntimeConfig();
|
|
@@ -1160,6 +1164,14 @@ class BambuPrinterMCPServer {
|
|
|
1160
1164
|
this.setupPromptHandlers();
|
|
1161
1165
|
this.setupToolHandlers();
|
|
1162
1166
|
}
|
|
1167
|
+
/** The running Blender add-on's get_addon_status, read through this server's Blender bridge (undefined when it has none). */
|
|
1168
|
+
async blenderAddonHandshake() {
|
|
1169
|
+
const signal = AbortSignal.timeout(20000);
|
|
1170
|
+
const status = await this.blender.status({ connect: true, timeout_ms: 15000 }, signal);
|
|
1171
|
+
if (status?.connected !== true || !status.tools?.some(tool => tool.name === "get_addon_status"))
|
|
1172
|
+
return undefined;
|
|
1173
|
+
return parseAddonHandshake(await this.blender.call({ tool_name: "get_addon_status", arguments: {}, timeout_ms: 15000 }, signal));
|
|
1174
|
+
}
|
|
1163
1175
|
/**
|
|
1164
1176
|
* The model for display-only counterpart tools: the argument, then the
|
|
1165
1177
|
* configured model, then the serial prefix. Never a safety decision and
|
|
@@ -3085,9 +3097,29 @@ class BambuPrinterMCPServer {
|
|
|
3085
3097
|
},
|
|
3086
3098
|
outputSchema: MAKE_3MF_OUTPUT_SCHEMA
|
|
3087
3099
|
},
|
|
3100
|
+
{
|
|
3101
|
+
name: "blender_mcp_setup",
|
|
3102
|
+
description: "Check or update the MCP for Blender add-on that the configured Blender bridge (BLENDER_MCP_COMMAND uvx, BLENDER_MCP_ARGS naming mcp-for-blender or blender-mcp) needs. Without update: which add-on file Blender loads, its protocol and the protocol the package expects, whether Blender is listening and the running add-on's own handshake. Changes nothing. With update: true, stages the add-on with the package's own installer (mcp-for-blender install-addon) at the inspected version, checks it, keeps the old file as a backup next to it and renames the new one into place. Never starts, stops or edits Blender; a running Blender uses the new add-on once it is re-enabled or restarted. A custom bridge returns supported false.",
|
|
3103
|
+
inputSchema: {
|
|
3104
|
+
type: "object",
|
|
3105
|
+
properties: { update: { type: "boolean", description: "Replace the installed add-on with the package's own (default false: check only)." } },
|
|
3106
|
+
additionalProperties: false
|
|
3107
|
+
},
|
|
3108
|
+
outputSchema: BLENDER_SETUP_OUTPUT_SCHEMA
|
|
3109
|
+
},
|
|
3110
|
+
{
|
|
3111
|
+
name: "fusion_mcp_setup",
|
|
3112
|
+
description: `Check or install what the Fusion bridge needs on macOS: Autodesk Fusion itself (found, never installed), the Fusion360MCP add-in from ${FUSION_ADDIN_REPOSITORY} at ${FUSION_MCP_PIN} (every file checked against its pinned SHA-256) set to run on startup, a login item that sets FUSION_MCP_PORT for Fusion however it is opened, and this server's FUSION_MCP_* settings. Without install: reports them and changes nothing. With install: true, installs what is missing and adds the missing settings to this server's own .env (after a copy of it), keeping a configured FUSION_MCP_COMMAND and its arguments. Never starts or quits Fusion; check the connection with fusion_mcp_status.`,
|
|
3113
|
+
inputSchema: {
|
|
3114
|
+
type: "object",
|
|
3115
|
+
properties: { install: { type: "boolean", description: "Install what is missing (default false: check only)." } },
|
|
3116
|
+
additionalProperties: false
|
|
3117
|
+
},
|
|
3118
|
+
outputSchema: FUSION_SETUP_OUTPUT_SCHEMA
|
|
3119
|
+
},
|
|
3088
3120
|
{
|
|
3089
3121
|
name: "fusion_mcp_status",
|
|
3090
|
-
description: `Check Autodesk Fusion through the configured Fusion MCP server (
|
|
3122
|
+
description: `Check Autodesk Fusion through the configured Fusion MCP server (fusion360-mcp-server, faust-machines or the pinned fork with document binding): whether it is configured, Fusion is running, the Fusion360MCP add-in answers on its port, and the server's tools and schemas. connected is true only when the add-in answers. With launch: true, starts Fusion on macOS when it is not running and waits up to 90 s for the add-in. Configure FUSION_MCP_COMMAND (uvx) and FUSION_MCP_ARGS (${JSON.stringify(FUSION_MCP_DEFAULT_ARGS)}), or run fusion_mcp_setup.`,
|
|
3091
3123
|
inputSchema: {
|
|
3092
3124
|
type: "object",
|
|
3093
3125
|
properties: {
|
|
@@ -4299,6 +4331,16 @@ class BambuPrinterMCPServer {
|
|
|
4299
4331
|
case "counterpart_make_3mf":
|
|
4300
4332
|
result = await makeCounterpart3mf(args ?? {});
|
|
4301
4333
|
break;
|
|
4334
|
+
case "blender_mcp_setup":
|
|
4335
|
+
if (args?.update !== undefined && typeof args.update !== "boolean")
|
|
4336
|
+
throw new Error("update must be a boolean.");
|
|
4337
|
+
result = args?.update === true ? await this.blenderSetup.update(extra.signal) : await this.blenderSetup.check();
|
|
4338
|
+
break;
|
|
4339
|
+
case "fusion_mcp_setup":
|
|
4340
|
+
if (args?.install !== undefined && typeof args.install !== "boolean")
|
|
4341
|
+
throw new Error("install must be a boolean.");
|
|
4342
|
+
result = args?.install === true ? await this.fusionSetup.install(extra.signal) : await this.fusionSetup.check();
|
|
4343
|
+
break;
|
|
4302
4344
|
case "fusion_mcp_status":
|
|
4303
4345
|
result = await this.fusion.status(args ?? {}, extra.signal);
|
|
4304
4346
|
break;
|
package/dist/tool-annotations.js
CHANGED
|
@@ -87,6 +87,10 @@ export const TOOL_ANNOTATIONS = {
|
|
|
87
87
|
// The standard route preserves scene objects and needs a new output path; a configured legacy bridge promises neither.
|
|
88
88
|
blender_mcp_edit_model: hints(false, true, false, true),
|
|
89
89
|
fusion_mcp_status: hints(false, false, true, true), // launch: true starts Fusion on this computer
|
|
90
|
+
// Install add-ons into the person's own Blender or Fusion: the add-on file is replaced (kept as a backup), and
|
|
91
|
+
// the Fusion add-in folder, a login item and this server's .env are written. Repeating finds them current.
|
|
92
|
+
blender_mcp_setup: hints(false, true, true, true),
|
|
93
|
+
fusion_mcp_setup: hints(false, true, true, true),
|
|
90
94
|
fusion_mcp_call: hints(false, true, false, true), // any Fusion tool, including execute_code
|
|
91
95
|
fusion_mcp_new_design: hints(false, false, false, true), // opens another new document
|
|
92
96
|
fusion_mcp_export: hints(false, false, true, true), // never overwrites; a repeat fails and changes nothing
|
package/package.json
CHANGED
|
@@ -41,6 +41,8 @@ export const REMOTE_SCOPES: Readonly<Record<string, RemoteScope>> = {
|
|
|
41
41
|
counterpart_printer_info: "read",
|
|
42
42
|
counterpart_print_progress: "read",
|
|
43
43
|
fusion_mcp_status: "read",
|
|
44
|
+
blender_mcp_setup: "read", // checks only; update raises it
|
|
45
|
+
fusion_mcp_setup: "read", // checks only; install raises it
|
|
44
46
|
// design
|
|
45
47
|
slice_stl: "design",
|
|
46
48
|
lay_flat: "design",
|
|
@@ -93,6 +95,8 @@ export const REMOTE_SCOPES: Readonly<Record<string, RemoteScope>> = {
|
|
|
93
95
|
const RAISED_BY: Readonly<Record<string, Record<string, RemoteScope>>> = {
|
|
94
96
|
fusion_mcp_status: { launch: "design" }, // starts Fusion on this computer
|
|
95
97
|
blender_mcp_status: { connect: "design" }, // connects to Blender
|
|
98
|
+
blender_mcp_setup: { update: "raw" }, // replaces the add-on in the person's Blender
|
|
99
|
+
fusion_mcp_setup: { install: "raw" }, // installs into the person's Fusion, a login item and this server's .env
|
|
96
100
|
};
|
|
97
101
|
|
|
98
102
|
/**
|