sweetspot-remote-agent 1.4.0 → 1.6.0

package/lib/apps.mjs

@@ -3,14 +3,56 @@ import os from "os";
 
 const platform = os.platform();
 
+// 한국어/약칭 → macOS 앱 이름 매핑
+const APP_ALIASES = {
+  "메모": "Notes", "메모장": "Notes", "notes": "Notes",
+  "사파리": "Safari", "safari": "Safari",
+  "크롬": "Google Chrome", "chrome": "Google Chrome", "구글크롬": "Google Chrome",
+  "파인더": "Finder", "finder": "Finder",
+  "터미널": "Terminal", "terminal": "Terminal",
+  "설정": "System Settings", "시스템설정": "System Settings",
+  "캘린더": "Calendar", "달력": "Calendar", "calendar": "Calendar",
+  "메일": "Mail", "mail": "Mail",
+  "메시지": "Messages", "messages": "Messages",
+  "음악": "Music", "music": "Music",
+  "사진": "Photos", "photos": "Photos",
+  "미리보기": "Preview", "preview": "Preview",
+  "계산기": "Calculator", "calculator": "Calculator",
+  "카카오톡": "KakaoTalk", "카톡": "KakaoTalk",
+  "슬랙": "Slack", "slack": "Slack",
+  "엑셀": "Microsoft Excel", "excel": "Microsoft Excel",
+  "워드": "Microsoft Word", "word": "Microsoft Word",
+  "파워포인트": "Microsoft PowerPoint", "ppt": "Microsoft PowerPoint",
+  "vscode": "Visual Studio Code", "코드": "Visual Studio Code",
+  "줌": "zoom.us", "zoom": "zoom.us",
+  "노션": "Notion", "notion": "Notion",
+  "피그마": "Figma", "figma": "Figma",
+  "텔레그램": "Telegram", "telegram": "Telegram",
+};
+
+function resolveAppName(appName) {
+  const lower = appName.toLowerCase().trim();
+  return APP_ALIASES[lower] || APP_ALIASES[appName] || appName;
+}
+
 export function openApp(appName) {
+  const resolved = resolveAppName(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 }); }
+    try {
+      execSync(`open -a "${resolved}"`, { timeout: 5000 });
+    } catch {
+      // Spotlight 검색으로 폴백
+      try {
+        execSync(`mdfind "kMDItemKind == 'Application'" | grep -i "${appName}" | head -1 | xargs open`, { timeout: 5000 });
+      } catch {
+        // AppleScript로 마지막 시도
+        execSync(`osascript -e 'tell application "${resolved}" to activate'`, { timeout: 5000 });
+      }
+    }
   } else if (platform === "win32") {
-    execSync(`powershell -Command "Start-Process '${appName}'"`, { timeout: 5000 });
+    execSync(`powershell -Command "Start-Process '${resolved}'"`, { timeout: 5000 });
   } else {
-    execSync(`${appName} &`, { timeout: 5000 });
+    execSync(`${resolved} &`, { timeout: 5000 });
   }
 }
 
@@ -31,15 +73,17 @@ export function listApps() {
 }
 
 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 });
+  const resolved = resolveAppName(appName);
+  if (platform === "darwin") execSync(`osascript -e 'tell application "${resolved}" to quit'`, { timeout: 5000 });
+  else if (platform === "win32") execSync(`powershell -Command "Stop-Process -Name '${resolved}' -Force"`, { timeout: 5000 });
+  else execSync(`pkill -f "${resolved}"`, { 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 });
+  const resolved = resolveAppName(appName);
+  if (platform === "darwin") execSync(`osascript -e 'tell application "${resolved}" to activate'`, { timeout: 5000 });
+  else if (platform === "win32") execSync(`powershell -Command "(Get-Process '${resolved}')[0].MainWindowHandle"`, { timeout: 5000 });
+  else execSync(`xdotool search --name "${resolved}" windowactivate`, { timeout: 5000 });
 }
 
 export function getClipboard() {
@@ -49,7 +93,11 @@ export function getClipboard() {
 }
 
 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 });
+  if (platform === "darwin") {
+    execSync("pbcopy", { input: text, timeout: 5000 });
+  } else if (platform === "win32") {
+    execSync(`powershell -Command "Set-Clipboard -Value '${text.replace(/'/g, "''")}'"`);
+  } else {
+    execSync("xclip -selection clipboard", { input: text, timeout: 5000 });
+  }
 }

package/lib/input.mjs

@@ -3,6 +3,11 @@ import os from "os";
 
 const platform = os.platform();
 
+// 텍스트에 비-ASCII 문자(한글 등)가 있는지 체크
+function hasNonAscii(text) {
+  return /[^\x00-\x7F]/.test(text);
+}
+
 export function click(x, y) {
   x = Math.round(x);
   y = Math.round(y);
@@ -34,11 +39,23 @@ export function doubleClick(x, y) {
 
 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 });
+    if (hasNonAscii(text)) {
+      // 한글 등 비-ASCII: 클립보드 경유 붙여넣기
+      execSync("pbcopy", { input: text, timeout: 5000 });
+      execSync(`osascript -e 'tell application "System Events" to keystroke "v" using command down'`, { timeout: 5000 });
+    } else {
+      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 });
+    if (hasNonAscii(text)) {
+      // Windows: 클립보드 경유
+      execSync(`powershell -Command "Set-Clipboard -Value '${text.replace(/'/g, "''")}'"`);
+      execSync(`powershell -Command "Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.SendKeys]::SendWait('^v')"`, { timeout: 5000 });
+    } else {
+      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 });
   }
@@ -82,8 +99,13 @@ export function hotkey(keys) {
 
 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 });
+    // cliclick scroll이 더 안정적
+    try {
+      execSync(`cliclick "scroll:0,${direction === "up" ? amount : -amount}"`, { timeout: 5000 });
+    } catch {
+      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++) {

package/mcp-server.js

@@ -17,109 +17,116 @@ import { click, doubleClick, typeText, pressKey, hotkey, scroll } from "./lib/in
 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) }] };
-});
+/**
+ * 도구를 등록한 McpServer 인스턴스를 생성
+ */
+function createServer() {
+  const srv = new McpServer({
+    name: "sweetspot-remote-agent",
+    version: "1.0.0",
+  });
+
+  // ── 스크린샷 ──
+  srv.tool("screenshot", "화면 스크린샷을 찍어 base64 PNG로 반환", {}, async () => {
+    const buf = await screenshot({ format: "png" });
+    return {
+      content: [{ type: "image", data: buf.toString("base64"), mimeType: "image/png" }],
+    };
+  });
+
+  // ── 마우스 ──
+  srv.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}) 완료` }] };
+  });
+
+  srv.tool("doubleclick", "마우스 더블 클릭", { x: z.number(), y: z.number() }, async ({ x, y }) => {
+    doubleClick(x, y);
+    return { content: [{ type: "text", text: `더블클릭 (${x}, ${y}) 완료` }] };
+  });
+
+  srv.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} 완료` }] };
+  });
+
+  // ── 키보드 ──
+  srv.tool("type", "텍스트 입력 (키보드 타이핑)", { text: z.string().describe("입력할 텍스트") }, async ({ text }) => {
+    typeText(text);
+    return { content: [{ type: "text", text: `입력 완료: "${text}"` }] };
+  });
+
+  srv.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} 완료` }] };
+  });
+
+  srv.tool("hotkey", "단축키 실행 (예: cmd+c, ctrl+v, alt+tab)", {
+    keys: z.string().describe("단축키 조합 (예: cmd+c)"),
+  }, async ({ keys }) => {
+    hotkey(keys);
+    return { content: [{ type: "text", text: `단축키 ${keys} 완료` }] };
+  });
+
+  // ── 앱 제어 ──
+  srv.tool("open_app", "앱 실행", { app: z.string().describe("앱 이름 (예: Chrome, Slack, Excel)") }, async ({ app }) => {
+    openApp(app);
+    return { content: [{ type: "text", text: `${app} 실행 완료` }] };
+  });
+
+  srv.tool("close_app", "앱 종료", { app: z.string().describe("앱 이름") }, async ({ app }) => {
+    closeApp(app);
+    return { content: [{ type: "text", text: `${app} 종료 완료` }] };
+  });
+
+  srv.tool("focus_app", "앱으로 포커스 전환", { app: z.string().describe("앱 이름") }, async ({ app }) => {
+    focusApp(app);
+    return { content: [{ type: "text", text: `${app} 포커스 완료` }] };
+  });
+
+  srv.tool("list_apps", "실행 중인 앱 목록 조회", {}, async () => {
+    const apps = listApps();
+    return { content: [{ type: "text", text: apps }] };
+  });
+
+  srv.tool("open_url", "URL을 기본 브라우저로 열기", { url: z.string().describe("URL") }, async ({ url }) => {
+    openUrl(url);
+    return { content: [{ type: "text", text: `${url} 열기 완료` }] };
+  });
+
+  // ── 클립보드 ──
+  srv.tool("get_clipboard", "클립보드 내용 읽기", {}, async () => {
+    const text = getClipboard();
+    return { content: [{ type: "text", text: text || "(빈 클립보드)" }] };
+  });
+
+  srv.tool("set_clipboard", "클립보드에 텍스트 복사", { text: z.string() }, async ({ text }) => {
+    setClipboard(text);
+    return { content: [{ type: "text", text: "클립보드에 복사 완료" }] };
+  });
+
+  // ── 셸 명령 ──
+  srv.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 || "(출력 없음)" }] };
+  });
+
+  // ── 시스템 정보 ──
+  srv.tool("sysinfo", "시스템 정보 조회 (OS, CPU, 메모리 등)", {}, async () => {
+    const info = getSystemInfo();
+    return { content: [{ type: "text", text: JSON.stringify(info, null, 2) }] };
+  });
+
+  return srv;
+}
 
 // ── 서버 시작 ──
 const args = process.argv.slice(2);
@@ -203,10 +210,12 @@ async function main() {
         const transport = new StreamableHTTPServerTransport({
           sessionIdGenerator: () => crypto.randomUUID(),
         });
+        // 세션마다 새 McpServer 인스턴스 생성 (멀티세션 지원)
+        const sessionServer = createServer();
         transport.onclose = () => {
           if (transport.sessionId) transports.delete(transport.sessionId);
         };
-        await server.connect(transport);
+        await sessionServer.connect(transport);
         await transport.handleRequest(req, res, req.body);
         if (transport.sessionId) transports.set(transport.sessionId, transport);
         return;
@@ -228,8 +237,9 @@ async function main() {
     });
   } else {
     // stdio 모드: 로컬 사용
+    const stdioServer = createServer();
     const transport = new StdioServerTransport();
-    await server.connect(transport);
+    await stdioServer.connect(transport);
     console.error("[remote-agent] MCP 서버 시작 (stdio)");
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sweetspot-remote-agent",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Sweetspot 원격 제어 MCP 서버 — 스크린샷, 마우스/키보드, 앱 제어, 셸 실행",
   "type": "module",
   "main": "mcp-server.js",