mcpscraper-memory 1.9.0 → 1.9.2
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.
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# mcp-memory
|
|
2
2
|
|
|
3
|
-
A hosted, multi-tenant MCP server for structured personal/business memory — notes across
|
|
3
|
+
A hosted, multi-tenant MCP server for structured personal/business memory — notes across 14
|
|
4
4
|
purpose-built vaults, semantic search, typeahead, and real structured data tables (typed columns,
|
|
5
5
|
filter, sort) — plus **Scheduled Actions**: freeform-text automations that run on a cadence, using
|
|
6
6
|
your [MCP Scraper](https://mcpscraper.dev) tools to gather live data and mcp-memory to store it.
|
|
@@ -8,6 +8,11 @@ your [MCP Scraper](https://mcpscraper.dev) tools to gather live data and mcp-mem
|
|
|
8
8
|
There is one backend: `https://memory.mcpscraper.dev`. This package is a thin local proxy to it —
|
|
9
9
|
every tool call is forwarded over HTTPS with your API key; nothing runs or is stored on your machine.
|
|
10
10
|
|
|
11
|
+
The backend consumes the shared `mcpscraper-memory-db` package for Postgres/PgVector storage, vault
|
|
12
|
+
contracts, Jina embeddings, and reranking, and `mcpscraper-memory-tools` for the public tool behavior.
|
|
13
|
+
Release those dependencies first, then update and redeploy this service before downstream products
|
|
14
|
+
advertise a newer memory-tool contract.
|
|
15
|
+
|
|
11
16
|
## Two ways to connect
|
|
12
17
|
|
|
13
18
|
**OAuth remote connector** (Claude.ai web, Claude Desktop's "Add custom connector") — no install,
|
|
@@ -31,6 +36,21 @@ Windsurf, and similar):
|
|
|
31
36
|
Get your key at `memory.mcpscraper.dev`, or from the mobile Scheduled Actions link
|
|
32
37
|
(`get-schedule-link`).
|
|
33
38
|
|
|
39
|
+
## Scheduled Actions access and billing
|
|
40
|
+
|
|
41
|
+
Scheduled Actions requires an active MCP Scraper Starter plan or higher. It is included with that
|
|
42
|
+
plan rather than sold as a separate subscription, and there is no separate monthly run quota.
|
|
43
|
+
|
|
44
|
+
- Every started scheduled occurrence costs 75 MCP Scraper Credits.
|
|
45
|
+
- Agent-mode runs also add 1.5 times OpenRouter's actual reported model cost.
|
|
46
|
+
- Deterministic `connection_sync` runs do not use a model, so they cost only the 75-Credit base.
|
|
47
|
+
- Creating, listing, pausing, or deleting definitions does not itself consume a scheduled-run charge.
|
|
48
|
+
|
|
49
|
+
MCP Scraper is the source of truth for paid-plan access and the Credit ledger. mcp-memory retains
|
|
50
|
+
the schedule definitions, default timezone, hosted-link key, and encrypted delegated MCP Scraper key;
|
|
51
|
+
historical entitlement/quota columns are migration data, not current runtime gates. See the live
|
|
52
|
+
[Scheduled Actions guide](https://mcpscraper.dev/scheduler) and [pricing](https://mcpscraper.dev/pricing).
|
|
53
|
+
|
|
34
54
|
## Environment variables
|
|
35
55
|
|
|
36
56
|
- `MCP_MEMORY_API_KEY` (or `MCP_MEMORY_KEY`) — required. Alternatively, write the key to
|
|
@@ -9,7 +9,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
|
|
|
9
9
|
import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
|
|
10
10
|
|
|
11
11
|
// src/version.ts
|
|
12
|
-
var PACKAGE_VERSION = "1.
|
|
12
|
+
var PACKAGE_VERSION = "1.9.2";
|
|
13
13
|
|
|
14
14
|
// bin/mcp-stdio-server.ts
|
|
15
15
|
var wantsHelp = process.argv.includes("--help") || process.argv.includes("-h");
|
|
@@ -1 +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.
|
|
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.9.2'\n"],"mappings":"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","names":[]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcpscraper-memory",
|
|
3
|
-
"version": "1.9.
|
|
3
|
+
"version": "1.9.2",
|
|
4
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
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -24,8 +24,8 @@
|
|
|
24
24
|
"@mastra/mcp": "latest",
|
|
25
25
|
"@mastra/pg": "latest",
|
|
26
26
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
27
|
-
"mcpscraper-memory-db": "^1.
|
|
28
|
-
"mcpscraper-memory-tools": "^1.
|
|
27
|
+
"mcpscraper-memory-db": "^1.5.0",
|
|
28
|
+
"mcpscraper-memory-tools": "^1.6.1",
|
|
29
29
|
"zod": "^3.25.0"
|
|
30
30
|
},
|
|
31
31
|
"devDependencies": {
|