mcpscraper-memory 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +40 -0
  2. package/dist/bin/mcp-stdio-server.js +123 -0
  3. package/dist/bin/mcp-stdio-server.js.map +1 -0
  4. package/package.json +44 -0
package/README.md ADDED
@@ -0,0 +1,40 @@
1
+ # mcp-memory
2
+
3
+ A hosted, multi-tenant MCP server for structured personal/business memory — notes across 13
4
+ purpose-built vaults, semantic search, typeahead, and real structured data tables (typed columns,
5
+ filter, sort) — plus **Scheduled Actions**: freeform-text automations that run on a cadence, using
6
+ your [MCP Scraper](https://mcpscraper.dev) tools to gather live data and mcp-memory to store it.
7
+
8
+ There is one backend: `https://memory.mcpscraper.dev`. This package is a thin local proxy to it —
9
+ every tool call is forwarded over HTTPS with your API key; nothing runs or is stored on your machine.
10
+
11
+ ## Two ways to connect
12
+
13
+ **OAuth remote connector** (Claude.ai web, Claude Desktop's "Add custom connector") — no install,
14
+ no key management. Add `https://memory.mcpscraper.dev/mcp` and log in.
15
+
16
+ **This package**, for clients that only support local stdio MCP servers (Claude Code, Cursor,
17
+ Windsurf, and similar):
18
+
19
+ ```json
20
+ {
21
+ "mcpServers": {
22
+ "mcp-memory": {
23
+ "command": "npx",
24
+ "args": ["-y", "mcpscraper-memory"],
25
+ "env": { "MCP_MEMORY_API_KEY": "mk_..." }
26
+ }
27
+ }
28
+ }
29
+ ```
30
+
31
+ Get your key at `memory.mcpscraper.dev`, or from the mobile Scheduled Actions link
32
+ (`get-schedule-link`).
33
+
34
+ ## Environment variables
35
+
36
+ - `MCP_MEMORY_API_KEY` (or `MCP_MEMORY_KEY`) — required. Alternatively, write the key to
37
+ `~/.mcp-memory-key` (or point `MCP_MEMORY_KEY_PATH` at a file containing it).
38
+ - `MCP_MEMORY_BASE_URL` — override the backend URL. Defaults to `https://memory.mcpscraper.dev`.
39
+
40
+ Run `npx mcpscraper-memory --help` for setup instructions from the terminal.
package/dist/bin/mcp-stdio-server.js ADDED
@@ -0,0 +1,123 @@
1
+ #!/usr/bin/env node
2
+
3
+ // bin/mcp-stdio-server.ts
4
+ import { readFileSync } from "fs";
5
+ import { homedir } from "os";
6
+ import { join } from "path";
7
+ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
8
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
9
+ import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
10
+
11
+ // src/version.ts
12
+ var PACKAGE_VERSION = "1.0.0";
13
+
14
+ // bin/mcp-stdio-server.ts
15
+ var wantsHelp = process.argv.includes("--help") || process.argv.includes("-h");
16
+ var forceStdio = process.argv.includes("--stdio") || process.env.MCP_MEMORY_FORCE_STDIO === "1";
17
+ var interactiveTerminal = Boolean(process.stdin.isTTY && process.stdout.isTTY);
18
+ function readApiKeyFile() {
19
+ const explicitPath = process.env.MCP_MEMORY_KEY_PATH?.trim();
20
+ const paths = [explicitPath, join(homedir(), ".mcp-memory-key")].filter(Boolean);
21
+ for (const path of paths) {
22
+ try {
23
+ const value = readFileSync(path, "utf8").trim();
24
+ if (value) return value;
25
+ } catch {
26
+ }
27
+ }
28
+ return void 0;
29
+ }
30
+ var apiKey = (process.env.MCP_MEMORY_API_KEY ?? process.env.MCP_MEMORY_KEY ?? readApiKeyFile())?.trim();
31
+ function renderHelp() {
32
+ const status = apiKey ? "configured" : "NOT configured";
33
+ return [
34
+ `mcp-memory v${PACKAGE_VERSION} \u2014 local stdio bridge to memory.mcpscraper.dev`,
35
+ "",
36
+ `API key: ${status}`,
37
+ "",
38
+ "This package is a thin proxy: every tool call is forwarded over HTTPS to",
39
+ "your hosted mcp-memory account, the same one used by the OAuth remote",
40
+ "connector. Nothing runs or is stored locally.",
41
+ "",
42
+ "Setup:",
43
+ " 1. Get your key from memory.mcpscraper.dev (or the mobile automations link).",
44
+ " 2. Set it: export MCP_MEMORY_API_KEY=mk_...",
45
+ " (or write it to ~/.mcp-memory-key)",
46
+ " 3. Add to your MCP client config:",
47
+ ' { "command": "npx", "args": ["-y", "mcpscraper-memory"],',
48
+ ' "env": { "MCP_MEMORY_API_KEY": "mk_..." } }',
49
+ "",
50
+ "Flags: --stdio (skip this screen and run directly), --help",
51
+ ""
52
+ ].join("\n");
53
+ }
54
+ if (!forceStdio && (interactiveTerminal || wantsHelp)) {
55
+ process.stdout.write(renderHelp());
56
+ process.exit(0);
57
+ }
58
+ if (!apiKey) {
59
+ process.stderr.write("MCP_MEMORY_API_KEY env var or ~/.mcp-memory-key is required\n");
60
+ process.exit(1);
61
+ }
62
+ var baseUrl = (process.env.MCP_MEMORY_BASE_URL?.trim() || "https://memory.mcpscraper.dev").replace(/\/$/, "");
63
+ var remoteUrl = `${baseUrl}/mcp`;
64
+ var rpcId = 0;
65
+ function parseRpcBody(text) {
66
+ const dataLine = text.split("\n").find((line) => line.startsWith("data:"));
67
+ const payload = dataLine ? dataLine.slice(5).trim() : text;
68
+ return JSON.parse(payload);
69
+ }
70
+ async function rpc(method, params) {
71
+ const res = await fetch(remoteUrl, {
72
+ method: "POST",
73
+ headers: {
74
+ "Content-Type": "application/json",
75
+ Accept: "application/json, text/event-stream",
76
+ Authorization: `Bearer ${apiKey}`
77
+ },
78
+ body: JSON.stringify({ jsonrpc: "2.0", id: ++rpcId, method, params })
79
+ });
80
+ const text = await res.text();
81
+ if (!res.ok) {
82
+ throw new Error(`mcp-memory HTTP ${res.status}: ${text.slice(0, 500)}`);
83
+ }
84
+ const body = parseRpcBody(text);
85
+ if (body.error) throw new Error(body.error.message ?? "remote mcp-memory error");
86
+ return body.result;
87
+ }
88
+ async function main() {
89
+ let remoteInfo = {};
90
+ try {
91
+ remoteInfo = await rpc("initialize", {
92
+ protocolVersion: "2025-06-18",
93
+ capabilities: {},
94
+ clientInfo: { name: "mcp-memory-stdio-proxy", version: PACKAGE_VERSION }
95
+ });
96
+ } catch (err) {
97
+ process.stderr.write(`Failed to reach ${remoteUrl}: ${err instanceof Error ? err.message : String(err)}
98
+ `);
99
+ process.exit(1);
100
+ }
101
+ const server = new Server(
102
+ { name: "mcp-memory", version: PACKAGE_VERSION },
103
+ { capabilities: { tools: {} }, instructions: remoteInfo.instructions }
104
+ );
105
+ server.setRequestHandler(ListToolsRequestSchema, async () => {
106
+ const result = await rpc("tools/list");
107
+ return { tools: result.tools };
108
+ });
109
+ server.setRequestHandler(CallToolRequestSchema, async (request) => {
110
+ return await rpc("tools/call", {
111
+ name: request.params.name,
112
+ arguments: request.params.arguments
113
+ });
114
+ });
115
+ const transport = new StdioServerTransport();
116
+ await server.connect(transport);
117
+ }
118
+ main().catch((err) => {
119
+ process.stderr.write(`${err instanceof Error ? err.message : String(err)}
120
+ `);
121
+ process.exit(1);
122
+ });
123
+ //# sourceMappingURL=mcp-stdio-server.js.map
package/dist/bin/mcp-stdio-server.js.map ADDED
@@ -0,0 +1 @@
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.0.0'\n"],"mappings":"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","names":[]}
package/package.json ADDED
@@ -0,0 +1,44 @@
1
+ {
2
+ "name": "mcpscraper-memory",
3
+ "version": "1.0.0",
4
+ "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.",
5
+ "type": "module",
6
+ "bin": {
7
+ "mcpscraper-memory": "dist/bin/mcp-stdio-server.js"
8
+ },
9
+ "files": [
10
+ "dist"
11
+ ],
12
+ "engines": {
13
+ "node": ">=22.13.0"
14
+ },
15
+ "scripts": {
16
+ "dev": "mastra dev",
17
+ "build": "mastra build",
18
+ "build:cli": "tsup",
19
+ "typecheck": "tsc --noEmit"
20
+ },
21
+ "dependencies": {
22
+ "@mastra/core": "latest",
23
+ "@mastra/deployer-vercel": "latest",
24
+ "@mastra/inngest": "latest",
25
+ "@mastra/mcp": "latest",
26
+ "@mastra/memory": "latest",
27
+ "@mastra/pg": "latest",
28
+ "@mastra/rag": "latest",
29
+ "@modelcontextprotocol/sdk": "^1.29.0",
30
+ "ai": "latest",
31
+ "inngest": "latest",
32
+ "jose": "^6.2.3",
33
+ "pg": "latest",
34
+ "zod": "^3.25.0"
35
+ },
36
+ "devDependencies": {
37
+ "@types/node": "latest",
38
+ "@types/pg": "latest",
39
+ "mastra": "latest",
40
+ "tsup": "^8.3.5",
41
+ "tsx": "^4.22.4",
42
+ "typescript": "^5.6.0"
43
+ }
44
+ }