sweetspot-remote-agent 1.7.0 → 1.8.0

package/mcp-server.js

@@ -125,6 +125,113 @@ function createServer() {
     return { content: [{ type: "text", text: JSON.stringify(info, null, 2) }] };
   });
 
+  // ── 파일 시스템 ──
+  srv.tool("list_files", "디렉토리 내용 조회. depth=0이면 해당 폴더만, depth=1이면 하위 1단계까지", {
+    path: z.string().default("~").describe("탐색할 경로"),
+    depth: z.number().default(0).describe("하위 탐색 깊이 (0=현재만, 1=하위1단계)"),
+  }, async ({ path: dirPath, depth }) => {
+    const { execSync } = await import("child_process");
+    const resolved = dirPath.replace(/^~/, process.env.HOME || "~");
+    try {
+      const cmd = depth > 0
+        ? `find "${resolved}" -maxdepth ${depth + 1} -not -name '.*' | head -200`
+        : `ls -la "${resolved}" | head -100`;
+      const output = execSync(cmd, { timeout: 10000, encoding: "utf-8" });
+      return { content: [{ type: "text", text: output || "(빈 디렉토리)" }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `오류: ${e.message}` }] };
+    }
+  });
+
+  srv.tool("read_file", "텍스트 파일 읽기 (txt, md, json, csv, tsv 등). 바이너리(PDF, 이미지, Excel)는 extract_file 사용", {
+    path: z.string().describe("파일 경로"),
+    lines: z.number().default(200).describe("최대 읽을 줄 수"),
+  }, async ({ path: filePath, lines }) => {
+    const { execSync } = await import("child_process");
+    const resolved = filePath.replace(/^~/, process.env.HOME || "~");
+    const ext = resolved.split(".").pop()?.toLowerCase() || "";
+    try {
+      // CSV → 탭 구분으로 변환해서 가독성 향상
+      if (ext === "csv") {
+        const output = execSync(`head -n ${lines} "${resolved}"`, { timeout: 10000, encoding: "utf-8", maxBuffer: 1024 * 100 });
+        const tsv = output.split("\\n").map(line => {
+          // 간단한 CSV→TSV (따옴표 내 쉼표 처리 포함)
+          const cells = [];
+          let cell = "", inQuote = false;
+          for (const ch of line) {
+            if (ch === '"') { inQuote = !inQuote; }
+            else if (ch === ',' && !inQuote) { cells.push(cell); cell = ""; }
+            else { cell += ch; }
+          }
+          cells.push(cell);
+          return cells.join("\\t");
+        }).join("\\n");
+        return { content: [{ type: "text", text: `[CSV → TSV 변환]\\n${tsv}` }] };
+      }
+      const output = execSync(`head -n ${lines} "${resolved}"`, { timeout: 10000, encoding: "utf-8", maxBuffer: 1024 * 50 });
+      return { content: [{ type: "text", text: output || "(빈 파일)" }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `오류: ${e.message}` }] };
+    }
+  });
+
+  srv.tool("extract_file", "바이너리 파일(PDF, 이미지, Excel)을 base64로 추출. 서버에서 Gemini Vision 등으로 처리", {
+    path: z.string().describe("파일 경로"),
+  }, async ({ path: filePath }) => {
+    const { readFileSync, statSync } = await import("fs");
+    const resolved = filePath.replace(/^~/, process.env.HOME || "~");
+    try {
+      const stat = statSync(resolved);
+      if (stat.size > 10 * 1024 * 1024) {
+        return { content: [{ type: "text", text: "오류: 파일이 10MB를 초과합니다" }] };
+      }
+      const ext = resolved.split(".").pop()?.toLowerCase() || "";
+      const buf = readFileSync(resolved);
+      const base64 = buf.toString("base64");
+      const mimeMap = {
+        pdf: "application/pdf", png: "image/png", jpg: "image/jpeg", jpeg: "image/jpeg",
+        gif: "image/gif", webp: "image/webp", xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        xls: "application/vnd.ms-excel", docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+      };
+      const mime = mimeMap[ext] || "application/octet-stream";
+      return { content: [{ type: "text", text: JSON.stringify({ type: "base64_file", mime, ext, size: stat.size, name: resolved.split("/").pop(), data: base64 }) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `오류: ${e.message}` }] };
+    }
+  });
+
+  srv.tool("search_files", "파일명 또는 파일 내용 검색", {
+    query: z.string().describe("검색어"),
+    path: z.string().default("~").describe("검색 시작 경로"),
+    content: z.boolean().default(false).describe("true면 파일 내용도 검색 (grep)"),
+  }, async ({ query, path: searchPath, content: searchContent }) => {
+    const { execSync } = await import("child_process");
+    const resolved = searchPath.replace(/^~/, process.env.HOME || "~");
+    try {
+      const cmd = searchContent
+        ? `grep -rl --include='*.{txt,md,json,csv,js,ts,py,html,css}' "${query}" "${resolved}" 2>/dev/null | head -20`
+        : `find "${resolved}" -maxdepth 4 -iname "*${query}*" -not -path '*/.*' 2>/dev/null | head -30`;
+      const output = execSync(cmd, { timeout: 15000, encoding: "utf-8" });
+      return { content: [{ type: "text", text: output || "검색 결과 없음" }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `오류: ${e.message}` }] };
+    }
+  });
+
+  srv.tool("file_info", "파일/폴더 메타데이터 (크기, 수정일, 타입)", {
+    path: z.string().describe("파일 경로"),
+  }, async ({ path: filePath }) => {
+    const { execSync } = await import("child_process");
+    const resolved = filePath.replace(/^~/, process.env.HOME || "~");
+    try {
+      const output = execSync(`stat -f "name: %N\nsize: %z bytes\nmodified: %Sm\ntype: %HT" "${resolved}"`, { timeout: 5000, encoding: "utf-8" });
+      return { content: [{ type: "text", text: output }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `오류: ${e.message}` }] };
+    }
+  });
+
   // ── AppleScript 실행 (macOS 전용, 앱 직접 제어) ──
   srv.tool("applescript", "AppleScript 실행 (macOS). 메모 작성, 앱 내부 조작 등에 사용", {
     script: z.string().describe("실행할 AppleScript 코드"),

package/package.json

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