sweetspot-remote-agent 1.0.0

package/bin/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+// MCP 서버 실행 (stdio 모드)
+import("../mcp-server.js");

package/lib/apps.mjs

@@ -0,0 +1,55 @@
+import { execSync } from "child_process";
+import os from "os";
+
+const platform = os.platform();
+
+export function openApp(appName) {
+  if (platform === "darwin") {
+    try { execSync(`open -a "${appName}"`, { timeout: 5000 }); }
+    catch { execSync(`mdfind "kMDItemKind == 'Application'" | grep -i "${appName}" | head -1 | xargs open`, { timeout: 5000 }); }
+  } else if (platform === "win32") {
+    execSync(`powershell -Command "Start-Process '${appName}'"`, { timeout: 5000 });
+  } else {
+    execSync(`${appName} &`, { timeout: 5000 });
+  }
+}
+
+export function openUrl(url) {
+  if (platform === "darwin") execSync(`open "${url}"`, { timeout: 5000 });
+  else if (platform === "win32") execSync(`powershell -Command "Start-Process '${url}'"`, { timeout: 5000 });
+  else execSync(`xdg-open "${url}"`, { timeout: 5000 });
+}
+
+export function listApps() {
+  if (platform === "darwin") {
+    return execSync(`osascript -e 'tell application "System Events" to get name of every process whose background only is false'`, { timeout: 5000 }).toString().trim();
+  } else if (platform === "win32") {
+    return execSync(`powershell -Command "Get-Process | Where-Object {$_.MainWindowTitle} | Select-Object -Property Name,MainWindowTitle | Format-Table -AutoSize"`, { timeout: 5000 }).toString().trim();
+  } else {
+    return execSync(`wmctrl -l 2>/dev/null || xdotool search --name '' getwindowname 2>/dev/null | head -20`, { timeout: 5000 }).toString().trim();
+  }
+}
+
+export function closeApp(appName) {
+  if (platform === "darwin") execSync(`osascript -e 'tell application "${appName}" to quit'`, { timeout: 5000 });
+  else if (platform === "win32") execSync(`powershell -Command "Stop-Process -Name '${appName}' -Force"`, { timeout: 5000 });
+  else execSync(`pkill -f "${appName}"`, { timeout: 5000 });
+}
+
+export function focusApp(appName) {
+  if (platform === "darwin") execSync(`osascript -e 'tell application "${appName}" to activate'`, { timeout: 5000 });
+  else if (platform === "win32") execSync(`powershell -Command "(Get-Process '${appName}')[0].MainWindowHandle"`, { timeout: 5000 });
+  else execSync(`xdotool search --name "${appName}" windowactivate`, { timeout: 5000 });
+}
+
+export function getClipboard() {
+  if (platform === "darwin") return execSync("pbpaste", { timeout: 5000 }).toString();
+  else if (platform === "win32") return execSync("powershell -Command Get-Clipboard", { timeout: 5000 }).toString();
+  else return execSync("xclip -selection clipboard -o 2>/dev/null || xsel --clipboard --output", { timeout: 5000 }).toString();
+}
+
+export function setClipboard(text) {
+  if (platform === "darwin") execSync(`echo "${text.replace(/"/g, '\\"')}" | pbcopy`, { timeout: 5000 });
+  else if (platform === "win32") execSync(`powershell -Command "Set-Clipboard -Value '${text.replace(/'/g, "''")}'"`);
+  else execSync(`echo "${text.replace(/"/g, '\\"')}" | xclip -selection clipboard`, { timeout: 5000 });
+}

package/lib/input.mjs

@@ -0,0 +1,96 @@
+import { execSync } from "child_process";
+import os from "os";
+
+const platform = os.platform();
+
+export function click(x, y) {
+  x = Math.round(x);
+  y = Math.round(y);
+  if (platform === "darwin") {
+    try {
+      execSync(`cliclick c:${x},${y}`, { timeout: 5000 });
+    } catch {
+      execSync(`osascript -e 'tell application "System Events" to click at {${x}, ${y}}'`, { timeout: 5000 });
+    }
+  } else if (platform === "win32") {
+    const ps = `Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.Cursor]::Position = New-Object System.Drawing.Point(${x},${y}); Add-Type -MemberDefinition '[DllImport("user32.dll")] public static extern void mouse_event(int f,int x,int y,int d,int e);' -Name U -Namespace W; [W.U]::mouse_event(2,0,0,0,0); [W.U]::mouse_event(4,0,0,0,0)`;
+    execSync(`powershell -Command "${ps}"`, { timeout: 5000 });
+  } else {
+    execSync(`xdotool mousemove ${x} ${y} click 1`, { timeout: 5000 });
+  }
+}
+
+export function doubleClick(x, y) {
+  x = Math.round(x);
+  y = Math.round(y);
+  if (platform === "darwin") {
+    try { execSync(`cliclick dc:${x},${y}`, { timeout: 5000 }); } catch { click(x, y); click(x, y); }
+  } else if (platform === "win32") {
+    click(x, y); click(x, y);
+  } else {
+    execSync(`xdotool mousemove ${x} ${y} click --repeat 2 1`, { timeout: 5000 });
+  }
+}
+
+export function typeText(text) {
+  if (platform === "darwin") {
+    const escaped = text.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    execSync(`osascript -e 'tell application "System Events" to keystroke "${escaped}"'`, { timeout: 10000 });
+  } else if (platform === "win32") {
+    const escaped = text.replace(/'/g, "''");
+    execSync(`powershell -Command "Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.SendKeys]::SendWait('${escaped}')"`, { timeout: 10000 });
+  } else {
+    execSync(`xdotool type -- "${text.replace(/"/g, '\\"')}"`, { timeout: 10000 });
+  }
+}
+
+export function pressKey(key) {
+  const macKeys = { enter: 36, tab: 48, escape: 53, backspace: 51, delete: 117, up: 126, down: 125, left: 123, right: 124, space: 49 };
+  const winKeys = { enter: "{ENTER}", tab: "{TAB}", escape: "{ESC}", backspace: "{BACKSPACE}", delete: "{DELETE}", up: "{UP}", down: "{DOWN}", left: "{LEFT}", right: "{RIGHT}", space: " " };
+  const linuxKeys = { enter: "Return", tab: "Tab", escape: "Escape", backspace: "BackSpace", delete: "Delete", up: "Up", down: "Down", left: "Left", right: "Right", space: "space" };
+
+  const k = key.toLowerCase();
+  if (platform === "darwin") {
+    const code = macKeys[k];
+    if (code !== undefined) execSync(`osascript -e 'tell application "System Events" to key code ${code}'`, { timeout: 5000 });
+  } else if (platform === "win32") {
+    const mapped = winKeys[k] || `{${key.toUpperCase()}}`;
+    execSync(`powershell -Command "Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.SendKeys]::SendWait('${mapped}')"`, { timeout: 5000 });
+  } else {
+    execSync(`xdotool key ${linuxKeys[k] || key}`, { timeout: 5000 });
+  }
+}
+
+export function hotkey(keys) {
+  const parts = keys.toLowerCase().split("+").map(k => k.trim());
+  if (platform === "darwin") {
+    const modMap = { cmd: "command", ctrl: "control", alt: "option", shift: "shift" };
+    const mods = parts.slice(0, -1).map(m => modMap[m] || m);
+    const key = parts[parts.length - 1];
+    const modStr = mods.map(m => `${m} down`).join(", ");
+    execSync(`osascript -e 'tell application "System Events" to keystroke "${key}" using {${modStr}}'`, { timeout: 5000 });
+  } else if (platform === "win32") {
+    const modMap = { ctrl: "^", alt: "%", shift: "+" };
+    let combo = "";
+    for (const p of parts.slice(0, -1)) combo += modMap[p] || "";
+    combo += parts[parts.length - 1];
+    execSync(`powershell -Command "Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.SendKeys]::SendWait('${combo}')"`, { timeout: 5000 });
+  } else {
+    execSync(`xdotool key ${parts.join("+")}`, { timeout: 5000 });
+  }
+}
+
+export function scroll(direction, amount = 3) {
+  if (platform === "darwin") {
+    const delta = direction === "up" ? amount : -amount;
+    execSync(`osascript -e 'tell application "System Events" to scroll ${delta}'`, { timeout: 5000 });
+  } else if (platform === "win32") {
+    const keyDir = direction === "up" ? "{UP}" : "{DOWN}";
+    for (let i = 0; i < amount; i++) {
+      execSync(`powershell -Command "Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.SendKeys]::SendWait('${keyDir}')"`, { timeout: 5000 });
+    }
+  } else {
+    const btn = direction === "up" ? 4 : 5;
+    execSync(`xdotool click --repeat ${amount} ${btn}`, { timeout: 5000 });
+  }
+}

package/lib/shell.mjs

@@ -0,0 +1,39 @@
+import { execSync } from "child_process";
+import os from "os";
+
+const ALLOWED_COMMANDS = [
+  "ls", "dir", "pwd", "cd", "cat", "head", "tail", "find", "grep",
+  "echo", "date", "whoami", "hostname", "uname",
+  "mkdir", "cp", "mv", "touch",
+  "df", "du", "free", "top", "ps",
+  "ping", "curl", "wget",
+  "python", "python3", "node", "npm", "npx",
+  "git", "code", "open", "start", "xdg-open",
+];
+
+const BLOCKED_PATTERNS = [
+  /rm\s+(-rf?|--force)/i, /rmdir/i, /format\s+/i, /dd\s+if=/i,
+  /mkfs/i, />\s*\/dev\//i, /shutdown/i, /reboot/i, /halt/i,
+  /kill\s+-9\s+1\b/i, /:(){ :|:& };:/,
+];
+
+export function runCommand(cmd, timeoutMs = 30000) {
+  for (const pattern of BLOCKED_PATTERNS) {
+    if (pattern.test(cmd)) throw new Error(`보안 정책에 의해 차단된 명령: ${cmd}`);
+  }
+  const firstCmd = cmd.split(/[\s|;&]/)[0].replace(/^.*\//, "");
+  if (!ALLOWED_COMMANDS.includes(firstCmd)) {
+    throw new Error(`허용되지 않은 명령어: ${firstCmd}`);
+  }
+  const result = execSync(cmd, { timeout: timeoutMs, maxBuffer: 1024 * 1024, cwd: os.homedir(), encoding: "utf-8" });
+  return result.length > 5000 ? result.slice(0, 5000) + `\n\n... (${result.length - 5000}자 생략)` : result;
+}
+
+export function getSystemInfo() {
+  return {
+    platform: os.platform(), arch: os.arch(), hostname: os.hostname(),
+    username: os.userInfo().username, homedir: os.homedir(),
+    cpus: os.cpus().length, memory: `${Math.round(os.totalmem() / 1024 / 1024 / 1024)}GB`,
+    uptime: `${Math.round(os.uptime() / 3600)}시간`,
+  };
+}

package/mcp-server.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+/**
+ * Sweetspot Remote Agent — MCP 서버
+ *
+ * 로컬 사용:  .mcp.json에 추가 (stdio)
+ * 원격 사용:  node mcp-server.js --sse --port 8080
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+import screenshot from "screenshot-desktop";
+import { click, doubleClick, typeText, pressKey, hotkey, scroll } from "./lib/input.mjs";
+import { openApp, openUrl, listApps, closeApp, focusApp, getClipboard, setClipboard } from "./lib/apps.mjs";
+import { runCommand, getSystemInfo } from "./lib/shell.mjs";
+
+const server = new McpServer({
+  name: "sweetspot-remote-agent",
+  version: "1.0.0",
+});
+
+// ── 스크린샷 ──
+server.tool("screenshot", "화면 스크린샷을 찍어 base64 PNG로 반환", {}, async () => {
+  const buf = await screenshot({ format: "png" });
+  return {
+    content: [{ type: "image", data: buf.toString("base64"), mimeType: "image/png" }],
+  };
+});
+
+// ── 마우스 ──
+server.tool("click", "마우스 클릭", { x: z.number().describe("X 좌표"), y: z.number().describe("Y 좌표") }, async ({ x, y }) => {
+  click(x, y);
+  return { content: [{ type: "text", text: `클릭 (${x}, ${y}) 완료` }] };
+});
+
+server.tool("doubleclick", "마우스 더블 클릭", { x: z.number(), y: z.number() }, async ({ x, y }) => {
+  doubleClick(x, y);
+  return { content: [{ type: "text", text: `더블클릭 (${x}, ${y}) 완료` }] };
+});
+
+server.tool("scroll", "마우스 스크롤", {
+  direction: z.enum(["up", "down"]).describe("방향"),
+  amount: z.number().default(3).describe("스크롤 양"),
+}, async ({ direction, amount }) => {
+  scroll(direction, amount);
+  return { content: [{ type: "text", text: `스크롤 ${direction} ${amount} 완료` }] };
+});
+
+// ── 키보드 ──
+server.tool("type", "텍스트 입력 (키보드 타이핑)", { text: z.string().describe("입력할 텍스트") }, async ({ text }) => {
+  typeText(text);
+  return { content: [{ type: "text", text: `입력 완료: "${text}"` }] };
+});
+
+server.tool("key", "특수키 입력 (enter, tab, escape, backspace, delete, up, down, left, right, space)", {
+  key: z.string().describe("키 이름"),
+}, async ({ key }) => {
+  pressKey(key);
+  return { content: [{ type: "text", text: `키 ${key} 완료` }] };
+});
+
+server.tool("hotkey", "단축키 실행 (예: cmd+c, ctrl+v, alt+tab)", {
+  keys: z.string().describe("단축키 조합 (예: cmd+c)"),
+}, async ({ keys }) => {
+  hotkey(keys);
+  return { content: [{ type: "text", text: `단축키 ${keys} 완료` }] };
+});
+
+// ── 앱 제어 ──
+server.tool("open_app", "앱 실행", { app: z.string().describe("앱 이름 (예: Chrome, Slack, Excel)") }, async ({ app }) => {
+  openApp(app);
+  return { content: [{ type: "text", text: `${app} 실행 완료` }] };
+});
+
+server.tool("close_app", "앱 종료", { app: z.string().describe("앱 이름") }, async ({ app }) => {
+  closeApp(app);
+  return { content: [{ type: "text", text: `${app} 종료 완료` }] };
+});
+
+server.tool("focus_app", "앱으로 포커스 전환", { app: z.string().describe("앱 이름") }, async ({ app }) => {
+  focusApp(app);
+  return { content: [{ type: "text", text: `${app} 포커스 완료` }] };
+});
+
+server.tool("list_apps", "실행 중인 앱 목록 조회", {}, async () => {
+  const apps = listApps();
+  return { content: [{ type: "text", text: apps }] };
+});
+
+server.tool("open_url", "URL을 기본 브라우저로 열기", { url: z.string().describe("URL") }, async ({ url }) => {
+  openUrl(url);
+  return { content: [{ type: "text", text: `${url} 열기 완료` }] };
+});
+
+// ── 클립보드 ──
+server.tool("get_clipboard", "클립보드 내용 읽기", {}, async () => {
+  const text = getClipboard();
+  return { content: [{ type: "text", text: text || "(빈 클립보드)" }] };
+});
+
+server.tool("set_clipboard", "클립보드에 텍스트 복사", { text: z.string() }, async ({ text }) => {
+  setClipboard(text);
+  return { content: [{ type: "text", text: "클립보드에 복사 완료" }] };
+});
+
+// ── 셸 명령 ──
+server.tool("shell", "셸 명령 실행 (보안 필터링 적용)", {
+  cmd: z.string().describe("실행할 명령어"),
+  timeout: z.number().default(30000).describe("타임아웃 (ms)"),
+}, async ({ cmd, timeout }) => {
+  const output = runCommand(cmd, timeout);
+  return { content: [{ type: "text", text: output || "(출력 없음)" }] };
+});
+
+// ── 시스템 정보 ──
+server.tool("sysinfo", "시스템 정보 조회 (OS, CPU, 메모리 등)", {}, async () => {
+  const info = getSystemInfo();
+  return { content: [{ type: "text", text: JSON.stringify(info, null, 2) }] };
+});
+
+// ── 서버 시작 ──
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("[remote-agent] MCP 서버 시작 (stdio)");
+}
+
+main().catch((err) => {
+  console.error("MCP 서버 실행 실패:", err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "sweetspot-remote-agent",
+  "version": "1.0.0",
+  "description": "Sweetspot 원격 제어 MCP 서버 — 스크린샷, 마우스/키보드, 앱 제어, 셸 실행",
+  "type": "module",
+  "main": "mcp-server.js",
+  "bin": {
+    "sweetspot-agent": "bin/cli.js"
+  },
+  "scripts": {
+    "start": "node mcp-server.js"
+  },
+  "files": [
+    "mcp-server.js",
+    "bin/",
+    "lib/*.mjs"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "screenshot-desktop": "^1.15.0",
+    "zod": "^4.3.6"
+  },
+  "license": "ISC",
+  "keywords": ["mcp", "remote-control", "screenshot", "automation"]
+}