screenpipe-mcp 0.14.0 → 0.15.0

package/dist/http-server.js

@@ -86,89 +86,86 @@ async function fetchAPI(endpoint, options = {}) {
         },
     });
 }
-// Create MCP server
-const server = new index_js_1.Server({
-    name: "screenpipe-http",
-    version: "0.8.2",
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-// List tools handler
-server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
-    return { tools: TOOLS };
-});
-// Call tool handler
-server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    if (!args) {
-        throw new Error("Missing arguments");
-    }
-    if (name === "search_content") {
-        const params = new URLSearchParams();
-        for (const [key, value] of Object.entries(args)) {
-            if (value !== null && value !== undefined) {
-                params.append(key, String(value));
-            }
-        }
-        const response = await fetchAPI(`/search?${params.toString()}`);
-        if (!response.ok) {
-            throw new Error(`HTTP error: ${response.status}`);
-        }
-        const data = await response.json();
-        const results = data.data || [];
-        const pagination = data.pagination || {};
-        if (results.length === 0) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "No results found. Try: broader search terms, different content_type, or wider time range.",
-                    },
-                ],
-            };
-        }
-        const formattedResults = [];
-        for (const result of results) {
-            const content = result.content;
-            if (!content)
-                continue;
-            if (result.type === "OCR") {
-                formattedResults.push(`[OCR] ${content.app_name || "?"} | ${content.window_name || "?"}\n` +
-                    `${content.timestamp || ""}\n` +
-                    `${content.text || ""}`);
-            }
-            else if (result.type === "Audio") {
-                formattedResults.push(`[Audio] ${content.device_name || "?"}\n` +
-                    `${content.timestamp || ""}\n` +
-                    `${content.transcription || ""}`);
-            }
-            else if (result.type === "UI" || result.type === "Accessibility") {
-                formattedResults.push(`[Accessibility] ${content.app_name || "?"} | ${content.window_name || "?"}\n` +
-                    `${content.timestamp || ""}\n` +
-                    `${content.text || ""}`);
-            }
+// Tool handler for search_content
+async function handleSearchContent(args) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(args)) {
+        if (value !== null && value !== undefined) {
+            params.append(key, String(value));
         }
-        const header = `Results: ${results.length}/${pagination.total || "?"}` +
-            (pagination.total > results.length ? ` (use offset=${(pagination.offset || 0) + results.length} for more)` : "");
+    }
+    const response = await fetchAPI(`/search?${params.toString()}`);
+    if (!response.ok) {
+        throw new Error(`HTTP error: ${response.status}`);
+    }
+    const data = await response.json();
+    const results = data.data || [];
+    const pagination = data.pagination || {};
+    if (results.length === 0) {
         return {
             content: [
                 {
                     type: "text",
-                    text: header + "\n\n" + formattedResults.join("\n---\n"),
+                    text: "No results found. Try: broader search terms, different content_type, or wider time range.",
                 },
             ],
         };
     }
-    throw new Error(`Unknown tool: ${name}`);
-});
-// Create HTTP server with MCP transport
-const transports = new Map();
+    const formattedResults = [];
+    for (const result of results) {
+        const content = result.content;
+        if (!content)
+            continue;
+        if (result.type === "OCR") {
+            formattedResults.push(`[OCR] ${content.app_name || "?"} | ${content.window_name || "?"}\n` +
+                `${content.timestamp || ""}\n` +
+                `${content.text || ""}`);
+        }
+        else if (result.type === "Audio") {
+            formattedResults.push(`[Audio] ${content.device_name || "?"}\n` +
+                `${content.timestamp || ""}\n` +
+                `${content.transcription || ""}`);
+        }
+        else if (result.type === "UI" || result.type === "Accessibility") {
+            formattedResults.push(`[Accessibility] ${content.app_name || "?"} | ${content.window_name || "?"}\n` +
+                `${content.timestamp || ""}\n` +
+                `${content.text || ""}`);
+        }
+    }
+    const header = `Results: ${results.length}/${pagination.total || "?"}` +
+        (pagination.total > results.length ? ` (use offset=${(pagination.offset || 0) + results.length} for more)` : "");
+    return {
+        content: [
+            {
+                type: "text",
+                text: header + "\n\n" + formattedResults.join("\n---\n"),
+            },
+        ],
+    };
+}
+// Create a fresh MCP Server instance with handlers registered.
+// Each HTTP session gets its own Server — the MCP SDK requires a 1:1
+// mapping between Server and transport (reusing a Server across
+// transports throws "Already connected to a transport").
+function createMcpServer() {
+    const s = new index_js_1.Server({ name: "screenpipe-http", version: "0.14.0" }, { capabilities: { tools: {} } });
+    s.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+    s.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        if (!args)
+            throw new Error("Missing arguments");
+        if (name === "search_content")
+            return handleSearchContent(args);
+        throw new Error(`Unknown tool: ${name}`);
+    });
+    return s;
+}
+// Per-session state: each session gets its own Server + transport pair.
+const sessions = new Map();
 const httpServer = (0, http_1.createServer)(async (req, res) => {
     // CORS headers
     res.setHeader("Access-Control-Allow-Origin", "*");
-    res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+    res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
     res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, mcp-session-id");
     if (req.method === "OPTIONS") {
         res.writeHead(204);
@@ -178,23 +175,25 @@ const httpServer = (0, http_1.createServer)(async (req, res) => {
     // Health check
     if (req.url === "/health") {
         res.writeHead(200, { "Content-Type": "application/json" });
-        res.end(JSON.stringify({ status: "ok" }));
+        res.end(JSON.stringify({ status: "ok", sessions: sessions.size }));
         return;
     }
     // MCP endpoint
     if (req.url === "/mcp" || req.url?.startsWith("/mcp?")) {
         const sessionId = req.headers["mcp-session-id"];
-        let transport = sessionId ? transports.get(sessionId) : undefined;
-        if (!transport) {
-            transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
+        let session = sessionId ? sessions.get(sessionId) : undefined;
+        if (!session) {
+            const server = createMcpServer();
+            const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
                 sessionIdGenerator: () => crypto.randomUUID(),
             });
             await server.connect(transport);
             if (transport.sessionId) {
-                transports.set(transport.sessionId, transport);
+                sessions.set(transport.sessionId, { server, transport });
             }
+            session = { server, transport };
         }
-        await transport.handleRequest(req, res);
+        await session.transport.handleRequest(req, res);
         return;
     }
     res.writeHead(404, { "Content-Type": "application/json" });

package/dist/index.js

@@ -53,6 +53,55 @@ for (let i = 0; i < args.length; i++) {
     }
 }
 const SCREENPIPE_API = `http://localhost:${port}`;
+// Discover API key: env var > npx screenpipe auth token > bundled bun
+function discoverApiKey() {
+    const envKey = process.env.SCREENPIPE_LOCAL_API_KEY || process.env.SCREENPIPE_API_KEY;
+    if (envKey)
+        return envKey;
+    const { execSync } = require("child_process");
+    const os = require("os");
+    const fs = require("fs");
+    const path = require("path");
+    // Try npx first (works if user has Node installed)
+    try {
+        const token = execSync("npx screenpipe@latest auth token", {
+            timeout: 15000,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        if (token)
+            return token;
+    }
+    catch { }
+    // Try bundled bun inside the screenpipe app
+    const bundledBunPaths = [];
+    const platform = os.platform();
+    if (platform === "darwin") {
+        bundledBunPaths.push("/Applications/screenpipe.app/Contents/MacOS/bun");
+    }
+    else if (platform === "win32") {
+        bundledBunPaths.push(path.join(process.env.LOCALAPPDATA || "", "screenpipe", "bun.exe"), path.join(process.env.PROGRAMFILES || "", "screenpipe", "bun.exe"));
+    }
+    else {
+        bundledBunPaths.push("/usr/lib/screenpipe/bun", "/opt/screenpipe/bun");
+    }
+    for (const bunPath of bundledBunPaths) {
+        try {
+            if (fs.existsSync(bunPath)) {
+                const token = execSync(`"${bunPath}" x screenpipe@latest auth token`, {
+                    timeout: 15000,
+                    encoding: "utf-8",
+                    stdio: ["pipe", "pipe", "pipe"],
+                }).trim();
+                if (token)
+                    return token;
+            }
+        }
+        catch { }
+    }
+    return "";
+}
+const API_KEY = discoverApiKey();
 // Read version from package.json (single source of truth)
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const PKG_VERSION = require("../package.json").version;
@@ -523,6 +572,7 @@ async function fetchAPI(endpoint, options = {}) {
         ...options,
         headers: {
             "Content-Type": "application/json",
+            ...(API_KEY ? { Authorization: `Bearer ${API_KEY}` } : {}),
             ...options.headers,
         },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "screenpipe-mcp",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "MCP server for screenpipe - search your screen recordings and audio transcriptions",
   "main": "dist/index.js",
   "bin": {

package/src/http-server.ts

@@ -96,109 +96,103 @@ async function fetchAPI(endpoint: string, options: RequestInit = {}): Promise<Re
   });
 }
 
-// Create MCP server
-const server = new Server(
-  {
-    name: "screenpipe-http",
-    version: "0.8.2",
-  },
-  {
-    capabilities: {
-      tools: {},
-    },
+// Tool handler for search_content
+async function handleSearchContent(args: Record<string, unknown>) {
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(args)) {
+    if (value !== null && value !== undefined) {
+      params.append(key, String(value));
+    }
   }
-);
-
-// List tools handler
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return { tools: TOOLS };
-});
-
-// Call tool handler
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
 
-  if (!args) {
-    throw new Error("Missing arguments");
+  const response = await fetchAPI(`/search?${params.toString()}`);
+  if (!response.ok) {
+    throw new Error(`HTTP error: ${response.status}`);
   }
 
-  if (name === "search_content") {
-    const params = new URLSearchParams();
-    for (const [key, value] of Object.entries(args)) {
-      if (value !== null && value !== undefined) {
-        params.append(key, String(value));
-      }
-    }
-
-    const response = await fetchAPI(`/search?${params.toString()}`);
-    if (!response.ok) {
-      throw new Error(`HTTP error: ${response.status}`);
-    }
-
-    const data = await response.json();
-    const results = data.data || [];
-    const pagination = data.pagination || {};
-
-    if (results.length === 0) {
-      return {
-        content: [
-          {
-            type: "text",
-            text: "No results found. Try: broader search terms, different content_type, or wider time range.",
-          },
-        ],
-      };
-    }
-
-    const formattedResults: string[] = [];
-    for (const result of results) {
-      const content = result.content;
-      if (!content) continue;
-
-      if (result.type === "OCR") {
-        formattedResults.push(
-          `[OCR] ${content.app_name || "?"} | ${content.window_name || "?"}\n` +
-          `${content.timestamp || ""}\n` +
-          `${content.text || ""}`
-        );
-      } else if (result.type === "Audio") {
-        formattedResults.push(
-          `[Audio] ${content.device_name || "?"}\n` +
-          `${content.timestamp || ""}\n` +
-          `${content.transcription || ""}`
-        );
-      } else if (result.type === "UI" || result.type === "Accessibility") {
-        formattedResults.push(
-          `[Accessibility] ${content.app_name || "?"} | ${content.window_name || "?"}\n` +
-          `${content.timestamp || ""}\n` +
-          `${content.text || ""}`
-        );
-      }
-    }
-
-    const header = `Results: ${results.length}/${pagination.total || "?"}` +
-      (pagination.total > results.length ? ` (use offset=${(pagination.offset || 0) + results.length} for more)` : "");
+  const data = await response.json();
+  const results = data.data || [];
+  const pagination = data.pagination || {};
 
+  if (results.length === 0) {
     return {
       content: [
         {
           type: "text",
-          text: header + "\n\n" + formattedResults.join("\n---\n"),
+          text: "No results found. Try: broader search terms, different content_type, or wider time range.",
         },
       ],
     };
   }
 
-  throw new Error(`Unknown tool: ${name}`);
-});
+  const formattedResults: string[] = [];
+  for (const result of results) {
+    const content = result.content;
+    if (!content) continue;
+
+    if (result.type === "OCR") {
+      formattedResults.push(
+        `[OCR] ${content.app_name || "?"} | ${content.window_name || "?"}\n` +
+        `${content.timestamp || ""}\n` +
+        `${content.text || ""}`
+      );
+    } else if (result.type === "Audio") {
+      formattedResults.push(
+        `[Audio] ${content.device_name || "?"}\n` +
+        `${content.timestamp || ""}\n` +
+        `${content.transcription || ""}`
+      );
+    } else if (result.type === "UI" || result.type === "Accessibility") {
+      formattedResults.push(
+        `[Accessibility] ${content.app_name || "?"} | ${content.window_name || "?"}\n` +
+        `${content.timestamp || ""}\n` +
+        `${content.text || ""}`
+      );
+    }
+  }
+
+  const header = `Results: ${results.length}/${pagination.total || "?"}` +
+    (pagination.total > results.length ? ` (use offset=${(pagination.offset || 0) + results.length} for more)` : "");
+
+  return {
+    content: [
+      {
+        type: "text",
+        text: header + "\n\n" + formattedResults.join("\n---\n"),
+      },
+    ],
+  };
+}
+
+// Create a fresh MCP Server instance with handlers registered.
+// Each HTTP session gets its own Server — the MCP SDK requires a 1:1
+// mapping between Server and transport (reusing a Server across
+// transports throws "Already connected to a transport").
+function createMcpServer(): Server {
+  const s = new Server(
+    { name: "screenpipe-http", version: "0.14.0" },
+    { capabilities: { tools: {} } }
+  );
+
+  s.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+  s.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    if (!args) throw new Error("Missing arguments");
+    if (name === "search_content") return handleSearchContent(args);
+    throw new Error(`Unknown tool: ${name}`);
+  });
+
+  return s;
+}
 
-// Create HTTP server with MCP transport
-const transports = new Map<string, StreamableHTTPServerTransport>();
+// Per-session state: each session gets its own Server + transport pair.
+const sessions = new Map<string, { server: Server; transport: StreamableHTTPServerTransport }>();
 
 const httpServer = createServer(async (req, res) => {
   // CORS headers
   res.setHeader("Access-Control-Allow-Origin", "*");
-  res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+  res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
   res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, mcp-session-id");
 
   if (req.method === "OPTIONS") {
@@ -210,7 +204,7 @@ const httpServer = createServer(async (req, res) => {
   // Health check
   if (req.url === "/health") {
     res.writeHead(200, { "Content-Type": "application/json" });
-    res.end(JSON.stringify({ status: "ok" }));
+    res.end(JSON.stringify({ status: "ok", sessions: sessions.size }));
     return;
   }
 
@@ -218,21 +212,23 @@ const httpServer = createServer(async (req, res) => {
   if (req.url === "/mcp" || req.url?.startsWith("/mcp?")) {
     const sessionId = req.headers["mcp-session-id"] as string | undefined;
 
-    let transport = sessionId ? transports.get(sessionId) : undefined;
+    let session = sessionId ? sessions.get(sessionId) : undefined;
 
-    if (!transport) {
-      transport = new StreamableHTTPServerTransport({
+    if (!session) {
+      const server = createMcpServer();
+      const transport = new StreamableHTTPServerTransport({
         sessionIdGenerator: () => crypto.randomUUID(),
       });
 
       await server.connect(transport);
 
       if (transport.sessionId) {
-        transports.set(transport.sessionId, transport);
+        sessions.set(transport.sessionId, { server, transport });
       }
+      session = { server, transport };
     }
 
-    await transport.handleRequest(req, res);
+    await session.transport.handleRequest(req, res);
     return;
   }
 

package/src/index.ts

@@ -28,6 +28,58 @@ for (let i = 0; i < args.length; i++) {
 
 const SCREENPIPE_API = `http://localhost:${port}`;
 
+// Discover API key: env var > npx screenpipe auth token > bundled bun
+function discoverApiKey(): string {
+  const envKey = process.env.SCREENPIPE_LOCAL_API_KEY || process.env.SCREENPIPE_API_KEY;
+  if (envKey) return envKey;
+
+  const { execSync } = require("child_process");
+  const os = require("os");
+  const fs = require("fs");
+  const path = require("path");
+
+  // Try npx first (works if user has Node installed)
+  try {
+    const token = execSync("npx screenpipe@latest auth token", {
+      timeout: 15000,
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+    }).trim();
+    if (token) return token;
+  } catch {}
+
+  // Try bundled bun inside the screenpipe app
+  const bundledBunPaths: string[] = [];
+  const platform = os.platform();
+  if (platform === "darwin") {
+    bundledBunPaths.push("/Applications/screenpipe.app/Contents/MacOS/bun");
+  } else if (platform === "win32") {
+    bundledBunPaths.push(
+      path.join(process.env.LOCALAPPDATA || "", "screenpipe", "bun.exe"),
+      path.join(process.env.PROGRAMFILES || "", "screenpipe", "bun.exe"),
+    );
+  } else {
+    bundledBunPaths.push("/usr/lib/screenpipe/bun", "/opt/screenpipe/bun");
+  }
+
+  for (const bunPath of bundledBunPaths) {
+    try {
+      if (fs.existsSync(bunPath)) {
+        const token = execSync(`"${bunPath}" x screenpipe@latest auth token`, {
+          timeout: 15000,
+          encoding: "utf-8",
+          stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        if (token) return token;
+      }
+    } catch {}
+  }
+
+  return "";
+}
+
+const API_KEY = discoverApiKey();
+
 // Read version from package.json (single source of truth)
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const PKG_VERSION: string = require("../package.json").version;
@@ -531,6 +583,7 @@ async function fetchAPI(
     ...options,
     headers: {
       "Content-Type": "application/json",
+      ...(API_KEY ? { Authorization: `Bearer ${API_KEY}` } : {}),
       ...options.headers,
     },
   });