mcpscraper-memory 1.14.0 → 1.15.1
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
|
@@ -51,6 +51,22 @@ the schedule definitions, default timezone, hosted-link key, and encrypted deleg
|
|
|
51
51
|
historical entitlement/quota columns are migration data, not current runtime gates. See the live
|
|
52
52
|
[Scheduled Actions guide](https://mcpscraper.dev/scheduler) and [pricing](https://mcpscraper.dev/pricing).
|
|
53
53
|
|
|
54
|
+
## Scheduled results and artifact templates
|
|
55
|
+
|
|
56
|
+
New scheduled executions have a durable result record separate from their automation definition
|
|
57
|
+
and scheduler receipt. Use `list_scheduled_runs` for the unopened inbox or broader history and pass
|
|
58
|
+
the returned opaque `runId` unchanged to `get_scheduled_run` and state-mutation tools.
|
|
59
|
+
|
|
60
|
+
`list_artifact_templates` returns the built-in Editorial Reading Room preset and saved templates.
|
|
61
|
+
Saving creates version 1; every edit creates a new immutable version. Automations select either
|
|
62
|
+
`{"mode":"none"}` or one exact saved template version. No artifact disables only rich report
|
|
63
|
+
rendering—it does not disable Memory-note or vault output.
|
|
64
|
+
|
|
65
|
+
The MCP resource `memory://scheduled-results-contract` provides the concise machine-readable
|
|
66
|
+
contract. Templates and rendered HTML are not embedded; existing Memory notes continue through the
|
|
67
|
+
normal indexing path. Expiring run-view links are issued by MCP Scraper and are separate from broad
|
|
68
|
+
Scheduled Actions management links.
|
|
69
|
+
|
|
54
70
|
## Environment variables
|
|
55
71
|
|
|
56
72
|
- `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.15.1";
|
|
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.15.1'\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.
|
|
3
|
+
"version": "1.15.1",
|
|
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": {
|
|
@@ -16,6 +16,7 @@
|
|
|
16
16
|
"dev": "mastra dev",
|
|
17
17
|
"build": "mastra build",
|
|
18
18
|
"build:cli": "tsup",
|
|
19
|
+
"test": "node --import tsx --test tests/*.test.mjs src/mastra/mcp/tools/*.test.ts",
|
|
19
20
|
"typecheck": "tsc --noEmit"
|
|
20
21
|
},
|
|
21
22
|
"dependencies": {
|
|
@@ -24,8 +25,8 @@
|
|
|
24
25
|
"@mastra/mcp": "latest",
|
|
25
26
|
"@mastra/pg": "latest",
|
|
26
27
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
27
|
-
"mcpscraper-memory-db": "
|
|
28
|
-
"mcpscraper-memory-tools": "
|
|
28
|
+
"mcpscraper-memory-db": "1.11.0",
|
|
29
|
+
"mcpscraper-memory-tools": "1.12.1",
|
|
29
30
|
"zod": "^3.25.0"
|
|
30
31
|
},
|
|
31
32
|
"devDependencies": {
|