mcpscraper-memory 1.18.0 → 1.18.1

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to MCP Memory are documented here. The format is based on [K
 
 ## [Unreleased]
 
+## [1.18.1] - 2026-08-13
+
+### Fixed
+
+- Build the standalone stdio CLI automatically before packing and publishing so the npm artifact contains its declared executable and source map.
+
 ## [1.18.0] - 2026-08-13
 
 ### Added
@@ -166,7 +172,8 @@ All notable changes to MCP Memory are documented here. The format is based on [K
 - The hosted service now consumes `mcpscraper-memory-db` 1.5 and `mcpscraper-memory-tools` 1.6, aligning direct OAuth and stdio clients with the current 14-vault Smart RAG contract, including bounded multi-query retrieval, graph expansion, and Jina reranking metadata.
 - Server guidance now documents the Skills vault and the exact hybrid retrieval workflow exposed by `memory-search`.
 
-[Unreleased]: https://github.com/VilovietaSEO/mcp-memory/compare/v1.18.0...HEAD
+[Unreleased]: https://github.com/VilovietaSEO/mcp-memory/compare/v1.18.1...HEAD
+[1.18.1]: https://github.com/VilovietaSEO/mcp-memory/compare/v1.18.0...v1.18.1
 [1.18.0]: https://github.com/VilovietaSEO/mcp-memory/compare/v1.17.2...v1.18.0
 [1.17.2]: https://github.com/VilovietaSEO/mcp-memory/compare/v1.17.1...v1.17.2
 [1.17.1]: https://github.com/VilovietaSEO/mcp-memory/compare/v1.17.0...v1.17.1

package/dist/bin/mcp-stdio-server.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+
+// bin/mcp-stdio-server.ts
+import { readFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+// src/version.ts
+var PACKAGE_VERSION = "1.18.1";
+
+// bin/mcp-stdio-server.ts
+var wantsHelp = process.argv.includes("--help") || process.argv.includes("-h");
+var forceStdio = process.argv.includes("--stdio") || process.env.MCP_MEMORY_FORCE_STDIO === "1";
+var interactiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+function readApiKeyFile() {
+  const explicitPath = process.env.MCP_MEMORY_KEY_PATH?.trim();
+  const paths = [explicitPath, join(homedir(), ".mcp-memory-key")].filter(Boolean);
+  for (const path of paths) {
+    try {
+      const value = readFileSync(path, "utf8").trim();
+      if (value) return value;
+    } catch {
+    }
+  }
+  return void 0;
+}
+var apiKey = (process.env.MCP_MEMORY_API_KEY ?? process.env.MCP_MEMORY_KEY ?? readApiKeyFile())?.trim();
+function renderHelp() {
+  const status = apiKey ? "configured" : "NOT configured";
+  return [
+    `mcp-memory v${PACKAGE_VERSION} \u2014 local stdio bridge to memory.mcpscraper.dev`,
+    "",
+    `API key: ${status}`,
+    "",
+    "This package is a thin proxy: every tool call is forwarded over HTTPS to",
+    "your hosted mcp-memory account, the same one used by the OAuth remote",
+    "connector. Nothing runs or is stored locally.",
+    "",
+    "Setup:",
+    "  1. Get your key from memory.mcpscraper.dev (or the mobile automations link).",
+    "  2. Set it: export MCP_MEMORY_API_KEY=mk_...",
+    "     (or write it to ~/.mcp-memory-key)",
+    "  3. Add to your MCP client config:",
+    '     { "command": "npx", "args": ["-y", "mcpscraper-memory"],',
+    '       "env": { "MCP_MEMORY_API_KEY": "mk_..." } }',
+    "",
+    "Flags: --stdio (skip this screen and run directly), --help",
+    ""
+  ].join("\n");
+}
+if (!forceStdio && (interactiveTerminal || wantsHelp)) {
+  process.stdout.write(renderHelp());
+  process.exit(0);
+}
+if (!apiKey) {
+  process.stderr.write("MCP_MEMORY_API_KEY env var or ~/.mcp-memory-key is required\n");
+  process.exit(1);
+}
+var baseUrl = (process.env.MCP_MEMORY_BASE_URL?.trim() || "https://memory.mcpscraper.dev").replace(/\/$/, "");
+var remoteUrl = `${baseUrl}/mcp`;
+var rpcId = 0;
+function parseRpcBody(text) {
+  const dataLine = text.split("\n").find((line) => line.startsWith("data:"));
+  const payload = dataLine ? dataLine.slice(5).trim() : text;
+  return JSON.parse(payload);
+}
+async function rpc(method, params) {
+  const res = await fetch(remoteUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Accept: "application/json, text/event-stream",
+      Authorization: `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({ jsonrpc: "2.0", id: ++rpcId, method, params })
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    throw new Error(`mcp-memory HTTP ${res.status}: ${text.slice(0, 500)}`);
+  }
+  const body = parseRpcBody(text);
+  if (body.error) throw new Error(body.error.message ?? "remote mcp-memory error");
+  return body.result;
+}
+async function main() {
+  let remoteInfo = {};
+  try {
+    remoteInfo = await rpc("initialize", {
+      protocolVersion: "2025-06-18",
+      capabilities: {},
+      clientInfo: { name: "mcp-memory-stdio-proxy", version: PACKAGE_VERSION }
+    });
+  } catch (err) {
+    process.stderr.write(`Failed to reach ${remoteUrl}: ${err instanceof Error ? err.message : String(err)}
+`);
+    process.exit(1);
+  }
+  const server = new Server(
+    { name: "mcp-memory", version: PACKAGE_VERSION },
+    { capabilities: { tools: {} }, instructions: remoteInfo.instructions }
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    const result = await rpc("tools/list");
+    return { tools: result.tools };
+  });
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    return await rpc("tools/call", {
+      name: request.params.name,
+      arguments: request.params.arguments
+    });
+  });
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((err) => {
+  process.stderr.write(`${err instanceof Error ? err.message : String(err)}
+`);
+  process.exit(1);
+});
+//# sourceMappingURL=mcp-stdio-server.js.map

package/dist/bin/mcp-stdio-server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../bin/mcp-stdio-server.ts","../../src/version.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { readFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js'\nimport { PACKAGE_VERSION } from '../src/version.js'\n\nconst wantsHelp = process.argv.includes('--help') || process.argv.includes('-h')\nconst forceStdio = process.argv.includes('--stdio') || process.env.MCP_MEMORY_FORCE_STDIO === '1'\nconst interactiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY)\n\nfunction readApiKeyFile(): string | undefined {\n  const explicitPath = process.env.MCP_MEMORY_KEY_PATH?.trim()\n  const paths = [explicitPath, join(homedir(), '.mcp-memory-key')].filter(Boolean) as string[]\n  for (const path of paths) {\n    try {\n      const value = readFileSync(path, 'utf8').trim()\n      if (value) return value\n    } catch {\n      void 0\n    }\n  }\n  return undefined\n}\n\nconst apiKey = (\n  process.env.MCP_MEMORY_API_KEY ??\n  process.env.MCP_MEMORY_KEY ??\n  readApiKeyFile()\n)?.trim()\n\nfunction renderHelp(): string {\n  const status = apiKey ? 'configured' : 'NOT configured'\n  return [\n    `mcp-memory v${PACKAGE_VERSION} — local stdio bridge to memory.mcpscraper.dev`,\n    '',\n    `API key: ${status}`,\n    '',\n    'This package is a thin proxy: every tool call is forwarded over HTTPS to',\n    'your hosted mcp-memory account, the same one used by the OAuth remote',\n    'connector. Nothing runs or is stored locally.',\n    '',\n    'Setup:',\n    '  1. Get your key from memory.mcpscraper.dev (or the mobile automations link).',\n    '  2. Set it: export MCP_MEMORY_API_KEY=mk_...',\n    '     (or write it to ~/.mcp-memory-key)',\n    '  3. Add to your MCP client config:',\n    '     { \"command\": \"npx\", \"args\": [\"-y\", \"mcpscraper-memory\"],',\n    '       \"env\": { \"MCP_MEMORY_API_KEY\": \"mk_...\" } }',\n    '',\n    'Flags: --stdio (skip this screen and run directly), --help',\n    '',\n  ].join('\\n')\n}\n\nif (!forceStdio && (interactiveTerminal || wantsHelp)) {\n  process.stdout.write(renderHelp())\n  process.exit(0)\n}\n\nif (!apiKey) {\n  process.stderr.write('MCP_MEMORY_API_KEY env var or ~/.mcp-memory-key is required\\n')\n  process.exit(1)\n}\n\nconst baseUrl = (process.env.MCP_MEMORY_BASE_URL?.trim() || 'https://memory.mcpscraper.dev').replace(/\\/$/, '')\nconst remoteUrl = `${baseUrl}/mcp`\n\nlet rpcId = 0\n\nfunction parseRpcBody(text: string): { result?: unknown; error?: { message?: string } } {\n  const dataLine = text.split('\\n').find((line) => line.startsWith('data:'))\n  const payload = dataLine ? dataLine.slice(5).trim() : text\n  return JSON.parse(payload)\n}\n\nasync function rpc(method: string, params?: Record<string, unknown>): Promise<unknown> {\n  const res = await fetch(remoteUrl, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      Accept: 'application/json, text/event-stream',\n      Authorization: `Bearer ${apiKey}`,\n    },\n    body: JSON.stringify({ jsonrpc: '2.0', id: ++rpcId, method, params }),\n  })\n  const text = await res.text()\n  if (!res.ok) {\n    throw new Error(`mcp-memory HTTP ${res.status}: ${text.slice(0, 500)}`)\n  }\n  const body = parseRpcBody(text)\n  if (body.error) throw new Error(body.error.message ?? 'remote mcp-memory error')\n  return body.result\n}\n\nasync function main(): Promise<void> {\n  let remoteInfo: { serverInfo?: { name?: string; version?: string }; instructions?: string } = {}\n  try {\n    remoteInfo = (await rpc('initialize', {\n      protocolVersion: '2025-06-18',\n      capabilities: {},\n      clientInfo: { name: 'mcp-memory-stdio-proxy', version: PACKAGE_VERSION },\n    })) as typeof remoteInfo\n  } catch (err) {\n    process.stderr.write(`Failed to reach ${remoteUrl}: ${err instanceof Error ? err.message : String(err)}\\n`)\n    process.exit(1)\n  }\n\n  const server = new Server(\n    { name: 'mcp-memory', version: PACKAGE_VERSION },\n    { capabilities: { tools: {} }, instructions: remoteInfo.instructions },\n  )\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => {\n    const result = (await rpc('tools/list')) as { tools: unknown[] }\n    return { tools: result.tools }\n  })\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    return (await rpc('tools/call', {\n      name: request.params.name,\n      arguments: request.params.arguments,\n    })) as Record<string, unknown>\n  })\n\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nmain().catch((err) => {\n  process.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`)\n  process.exit(1)\n})\n","export const PACKAGE_VERSION = '1.18.1'\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-memory",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "mcp-memory — a hosted, multi-tenant, access-controlled per-user Obsidian/Neon memory exposed AS an MCP server, with a scheduled optimization layer. Its own standalone MCP product.",
   "type": "module",
   "bin": {
@@ -24,6 +24,7 @@
     "dev": "mastra dev",
     "build": "mastra build",
     "build:cli": "tsup",
+    "prepack": "npm run build:cli",
     "test": "node --import tsx --test tests/*.test.mjs src/mastra/mcp/tools/*.test.ts",
     "typecheck": "tsc --noEmit"
   },