creavit-studio-mcp 1.3.0 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "creavit-studio-mcp",
-	"version": "1.3.0",
+	"version": "1.3.1",
 	"description": "MCP server that lets AI coding agents (Claude Code, Codex, Cursor) drive the Creavit Studio screen recording app",
 	"keywords": [
 		"mcp",

package/src/bridgeClient.mjs

@@ -12,6 +12,9 @@ import { ensureAppRunning, isAutoLaunchEnabled } from "./appLauncher.mjs";
 const DEFAULT_ENDPOINT_DIRS = [
 	path.join(os.homedir(), "Library", "Application Support", "creavit-studio"),
 	path.join(os.homedir(), "Library", "Application Support", "Creavit Studio"),
+	// `npm run electron:dev` paketlenmemiş çalıştığı için userData "Electron"
+	// altına düşer. Bu olmadan MCP dev build'i hiç göremez.
+	path.join(os.homedir(), "Library", "Application Support", "Electron"),
 ];
 
 export class BridgeUnavailableError extends Error {

package/src/tools/index.mjs

@@ -5,6 +5,7 @@ import { editorTools } from "./editorTools.mjs";
 import { motionTools } from "./motionTools.mjs";
 import { systemTools } from "./systemTools.mjs";
 import { browserTools } from "./browserTools.mjs";
+import { inputTools } from "./inputTools.mjs";
 import { escapeTools } from "./escapeTools.mjs";
 import { errorResult } from "./defineTool.mjs";
 import { BridgeUnavailableError } from "../bridgeClient.mjs";
@@ -19,6 +20,7 @@ function buildRegistry() {
 		...editorTools(),
 		...motionTools(),
 		...browserTools(),
+		...inputTools(),
 		...escapeTools(),
 	];
 

package/src/tools/inputTools.mjs

@@ -0,0 +1,134 @@
+// MCP araçları — sistem faresi ve klavyesi.
+// browser_* araçlarından farkı: izole capture penceresine bağlı değiller,
+// ekrandaki herhangi bir uygulamayı sürerler.
+
+import { bridgeTool, schema, S } from "./defineTool.mjs";
+
+const STEP_SCHEMA = S.object(
+	"One step: {action:'move',x,y,durationMs} | {action:'click',clickCount} | {action:'down'|'up'} | {action:'type',text,perCharMs} | {action:'key',key,modifiers} | {action:'wait',ms}",
+);
+
+export function inputTools() {
+	return [
+		bridgeTool({
+			name: "creavit_input_click",
+			command: "input.click",
+			description:
+				"Moves the real system mouse to a screen coordinate and clicks. For a point inside a window use creavit_input_window_click instead — it does the coordinate math for you.",
+			inputSchema: schema(
+				{
+					x: S.number("Screen X"),
+					y: S.number("Screen Y"),
+					durationMs: S.number("Travel time for the move (default 450)"),
+					clickCount: S.number("1 = click, 2 = double-click"),
+				},
+				["x", "y"],
+			),
+			timeoutMs: 30_000,
+		}),
+
+		bridgeTool({
+			name: "creavit_input_move",
+			command: "input.moveMouse",
+			description: "Moves the real system mouse to a screen coordinate, without clicking.",
+			inputSchema: schema(
+				{
+					x: S.number("Screen X"),
+					y: S.number("Screen Y"),
+					durationMs: S.number("Travel time (default 450)"),
+				},
+				["x", "y"],
+			),
+			timeoutMs: 30_000,
+		}),
+
+		bridgeTool({
+			name: "creavit_input_window_click",
+			command: "input.windowClick",
+			description:
+				"Clicks inside a window from creavit_devices_list, using window-relative coordinates (or 0-1 with normalized:true). Brings the window's owner app to the front first — this is the click to use while recording a window.",
+			inputSchema: schema(
+				{
+					windowId: S.number("Window id from creavit_devices_list"),
+					x: S.number("Window-relative X (px, or 0-1 when normalized)"),
+					y: S.number("Window-relative Y"),
+					normalized: S.bool("Treat x/y as 0-1 fractions of the window (default false)"),
+					durationMs: S.number("Travel time (default 450)"),
+					clickCount: S.number("1 = click, 2 = double-click"),
+					activate: S.bool("Bring the owner app to the front first (default true)"),
+				},
+				["windowId", "x", "y"],
+			),
+			timeoutMs: 60_000,
+		}),
+
+		bridgeTool({
+			name: "creavit_input_type",
+			command: "input.type",
+			description:
+				"Types text into whatever is focused. Click the field first. perCharMs types character by character, which looks natural in a recording.",
+			inputSchema: schema(
+				{
+					text: S.string("Text to type (UTF-8; Turkish characters are fine)"),
+					perCharMs: S.number("Delay per character, 0 = all at once (default 0)"),
+					pressEnter: S.bool("Press Return afterwards (default false)"),
+				},
+				["text"],
+			),
+			timeoutMs: 120_000,
+		}),
+
+		bridgeTool({
+			name: "creavit_input_key",
+			command: "input.key",
+			description:
+				"Presses a single key with optional modifiers. Keys: return, tab, space, delete, escape, left/right/up/down, home, end, pageup, pagedown. Modifiers: cmd, shift, alt, ctrl.",
+			inputSchema: schema(
+				{
+					key: S.string("Key name"),
+					modifiers: S.array("Modifiers held down", S.string("cmd|shift|alt|ctrl")),
+				},
+				["key"],
+			),
+			timeoutMs: 30_000,
+		}),
+
+		bridgeTool({
+			name: "creavit_record_walkthrough",
+			command: "recording.walkthrough",
+			description:
+				"Records a walkthrough in ONE call: starts recording, runs the input steps, stops. USE THIS to record an interaction — the recorded length is leadMs + steps + tailMs and nothing else. Driving it by hand (start, then sequence, then stop) adds your own round-trip time to the video; measured, an 8.7s scenario became a 22.5s recording. With sourceType 'window' the step coordinates are window-relative by default.",
+			inputSchema: schema(
+				{
+					options: S.object(
+						"Recording options, same as creavit_recording_start: {sourceType:'display'|'window'|'area', sourceId, cameraEnabled, micEnabled, systemAudioEnabled, area}",
+					),
+					steps: S.array("Input steps, executed in order", STEP_SCHEMA),
+					leadMs: S.number("Idle time before the first step (default 800)"),
+					tailMs: S.number("Idle time after the last step (default 1200)"),
+					normalized: S.bool("Treat move x/y as 0-1 fractions of the window (default false)"),
+					windowRelative: S.bool("Step coordinates are window-relative (default true for window recordings)"),
+				},
+				["options", "steps"],
+			),
+			timeoutMs: 900_000,
+		}),
+
+		bridgeTool({
+			name: "creavit_input_sequence",
+			command: "input.sequence",
+			description:
+				"Runs a whole input scenario inside the app in ONE native process, so its wall-clock duration is exactly what you asked for. USE THIS WHILE RECORDING — driving a recording with separate click/type calls adds each round-trip to the recorded video. Pass windowId to write move steps in window-relative coordinates.",
+			inputSchema: schema(
+				{
+					steps: S.array("Steps, executed in order", STEP_SCHEMA),
+					windowId: S.number("Window id — makes move steps window-relative"),
+					normalized: S.bool("Treat move x/y as 0-1 fractions of the window (default false)"),
+					activate: S.bool("Bring the owner app to the front first (default true)"),
+				},
+				["steps"],
+			),
+			timeoutMs: 600_000,
+		}),
+	];
+}