brainferno-mcp-bridge 0.1.0

package/dist/server.js

@@ -0,0 +1,90 @@
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeServer } from "./bridge/socket.js";
+import { AmeWebService } from "./drivers/ame-webservice.js";
+import { IllustratorDelegate } from "./drivers/illustrator-delegate.js";
+import { OsScriptBridge } from "./drivers/osscript.js";
+import { JobRegistry } from "./jobs.js";
+import { setLogLevel } from "./logging.js";
+import { registerAfterEffectsTools } from "./tools/after-effects.js";
+import { registerAudioTools } from "./tools/audio.js";
+import { registerAuditionTools } from "./tools/audition.js";
+import { registerDiagnosticTools } from "./tools/diagnostics.js";
+import { registerIllustratorTools } from "./tools/illustrator.js";
+import { registerIllustratorDelegateTools } from "./tools/illustrator-delegate.js";
+import { registerJobTools } from "./tools/jobs.js";
+import { registerMediaEncoderTools } from "./tools/media-encoder.js";
+import { registerPhotoshopTools } from "./tools/photoshop.js";
+import { registerPipelineTools } from "./tools/pipelines.js";
+import { registerPremiereTools } from "./tools/premiere.js";
+export function buildRuntime(config) {
+    setLogLevel(config.logLevel);
+    const bridge = new BridgeServer({
+        port: config.bridgePort,
+        token: config.bridgeToken,
+        insecure: config.bridgeInsecure,
+        defaultTimeoutMs: config.evalTimeoutMs,
+        heartbeatIntervalMs: config.heartbeatIntervalMs,
+        handshakeFilePath: config.handshakeFilePath,
+        allowedOrigins: config.allowedOrigins,
+    });
+    const illustratorBridge = new OsScriptBridge({ appId: "illustrator", defaultTimeoutMs: config.evalTimeoutMs });
+    const illustratorDelegate = new IllustratorDelegate({ url: config.illustratorMcpUrl, token: config.illustratorMcpKey });
+    // Job work folders sit beside the handshake file (~/.brainferno-mcp-bridge/work/<jobId>/).
+    const jobs = new JobRegistry({ workRoot: join(dirname(config.handshakeFilePath) || join(homedir(), ".brainferno-mcp-bridge"), "work") });
+    const mediaEncoder = new AmeWebService({ exePath: config.ameWebServicePath, port: config.amePort, extraArgs: [], idleMs: config.ameIdleMs });
+    const audio = { ffmpegPath: config.ffmpegPath, ffprobePath: config.ffprobePath };
+    return { config, bridge, illustratorBridge, illustratorDelegate, jobs, mediaEncoder, audio };
+}
+/**
+ * A new McpServer with every tool registered against the shared runtime.
+ * Tools are registered unconditionally: an application that has no panel
+ * connected still advertises its tools, and those tools return an actionable
+ * "not connected" error rather than vanishing from the tool list mid-session.
+ */
+export function createMcpServer(rt) {
+    const { config, bridge, jobs } = rt;
+    const server = new McpServer({ name: "brainferno-mcp-bridge", version: "0.1.0" }, {
+        capabilities: { tools: {} },
+        instructions: "Drives Adobe Creative Cloud production applications. Each tool acts on the application that is already " +
+            "open on the operator's machine, on the project they currently have loaded — there is no separate workspace. " +
+            "Call cc_connected_apps first to see which applications are reachable.",
+    });
+    // The installer's app choice: only chosen apps get tools (and pipelines that need them).
+    const on = new Set(config.enabledApps);
+    const appIds = ["after_effects", "premiere", "photoshop", "illustrator", "audition"].filter((id) => on.has(id));
+    registerDiagnosticTools(server, bridge, { allowRawScripts: config.allowRawScripts, enabledApps: appIds });
+    if (on.has("after_effects"))
+        registerAfterEffectsTools(server, bridge.bridgeFor("after_effects"), { jobs });
+    if (on.has("premiere"))
+        registerPremiereTools(server, bridge.bridgeFor("premiere"), { jobs });
+    if (on.has("photoshop"))
+        registerPhotoshopTools(server, bridge.bridgeFor("photoshop"), { allowRawScripts: config.allowRawScripts });
+    if (on.has("illustrator")) {
+        registerIllustratorTools(server, rt.illustratorBridge);
+        registerIllustratorDelegateTools(server, rt.illustratorDelegate, config.illustratorMcpKey !== "");
+    }
+    if (on.has("audition"))
+        registerAuditionTools(server, bridge.bridgeFor("audition"));
+    registerAudioTools(server, rt.audio);
+    registerJobTools(server, jobs);
+    if (on.has("media_encoder"))
+        registerMediaEncoderTools(server, rt.mediaEncoder, { jobs });
+    registerPipelineTools(server, {
+        photoshop: bridge.bridgeFor("photoshop"),
+        afterEffects: bridge.bridgeFor("after_effects"),
+        premiere: bridge.bridgeFor("premiere"),
+        illustrator: rt.illustratorBridge,
+        jobs,
+        audio: rt.audio,
+        enabled: on,
+    });
+    return server;
+}
+/** Runtime plus one McpServer (the stdio session). */
+export function buildServer(config) {
+    const rt = buildRuntime(config);
+    return { ...rt, server: createMcpServer(rt) };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/after-effects.d.ts

@@ -0,0 +1,100 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AppBridge } from "../bridge/types.js";
+import type { JobRegistry } from "../jobs.js";
+export declare const LIST_COMPOSITIONS: string;
+export declare const PROJECT_INFO: string;
+export declare const LIST_FOOTAGE: string;
+export declare function getCompScript(compId: number): string;
+export declare function getLayerScript(compId: number, layerIndex: number): string;
+export declare function openProjectScript(path: string): string;
+export declare function saveProjectScript(path: string | undefined): string;
+export declare function importFootageScript(path: string): string;
+export interface CreateCompParams {
+    name: string;
+    width: number;
+    height: number;
+    frameRate: number;
+    duration: number;
+    pixelAspect: number;
+}
+export declare function createCompScript(p: CreateCompParams): string;
+export interface AddLayerParams {
+    compId: number;
+    kind: "footage" | "solid" | "text" | "null" | "adjustment";
+    itemId?: number;
+    color?: string;
+    name?: string;
+    text?: string;
+    width?: number;
+    height?: number;
+}
+export declare function addLayerScript(p: AddLayerParams): string;
+export interface LayerProps {
+    name?: string;
+    enabled?: boolean;
+    inPoint?: number;
+    outPoint?: number;
+    startTime?: number;
+    position?: number[];
+    scale?: number[];
+    rotation?: number;
+    opacity?: number;
+    anchorPoint?: number[];
+    parentIndex?: number | null;
+}
+export declare function setLayerPropsScript(compId: number, layerIndex: number, p: LayerProps): string;
+export declare function duplicateLayerScript(compId: number, layerIndex: number, name: string | undefined): string;
+export declare function deleteLayerScript(compId: number, layerIndex: number): string;
+export interface KeyframeParams {
+    compId: number;
+    layerIndex: number;
+    property: string;
+    propertyPath?: string[];
+    keys: {
+        time: number;
+        value: number | number[];
+        easy?: boolean;
+    }[];
+}
+export declare function setKeyframesScript(p: KeyframeParams): string;
+export declare function getKeyframesScript(compId: number, layerIndex: number, property: string, propertyPath: string[] | undefined): string;
+export declare function removeKeyframesScript(compId: number, layerIndex: number, property: string, propertyPath: string[] | undefined): string;
+export declare function setExpressionScript(compId: number, layerIndex: number, property: string, propertyPath: string[] | undefined, expression: string | null): string;
+export declare function applyEffectScript(compId: number, layerIndex: number, matchName: string): string;
+export declare function setEffectParamScript(compId: number, layerIndex: number, effect: number | string, param: string, value: number | number[] | string): string;
+export interface SetTextParams {
+    compId: number;
+    layerIndex: number;
+    text?: string;
+    fontSize?: number;
+    font?: string;
+    color?: string;
+    justification?: "left" | "center" | "right";
+}
+export declare function setTextScript(p: SetTextParams): string;
+export declare function addMarkerScript(compId: number, time: number, comment: string, layerIndex: number | undefined, duration: number | undefined): string;
+export declare function renderFrameScript(compId: number, time: number, path: string, maxDimension: number): string;
+export declare const AERENDER_INFO: string;
+export interface RenderCompOptions {
+    compName: string;
+    outputPath: string;
+    outputModule?: string;
+    renderSettings?: string;
+}
+/**
+ * Save the project, then render one comp with aerender. Shared by the
+ * ae_render_comp tool and the pipelines; throws with an actionable message.
+ */
+export declare function renderCompHeadless(bridge: AppBridge, o: RenderCompOptions, ctx?: {
+    signal?: AbortSignal;
+    log?: (line: string) => void;
+}): Promise<{
+    outputPath: string;
+    compName: string;
+    log: string;
+}>;
+export interface AfterEffectsToolOptions {
+    /** When given, ae_render_comp runs as a job (progress, cancel, wait:false). */
+    jobs?: JobRegistry;
+}
+export declare function registerAfterEffectsTools(server: McpServer, bridge: AppBridge, options?: AfterEffectsToolOptions): void;