@luisarg/memory-mcp 0.1.0

package/README.md

@@ -0,0 +1,39 @@
+# @luisarg/memory-mcp
+
+Cordis bundle that connects [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/)
+(DSH) to a persistent OKF memory vault over the Model Context Protocol.
+
+It mounts `@deepseek-ai/dsh-mcp-client` configured for the vault's Python MCP
+server (`memory-vault-server` in this repository) over stdio, exposing the
+vault's tools (`search_memory`, `store_*`, `export_memories`, `get_profile`,
+`ping`) to the agent.
+
+## Install
+
+```sh
+dsh plugin --profile web add @luisarg/memory-mcp
+```
+
+Requires `uv` on PATH — the plugin spawns the server with `uv run`.
+
+## Configuration
+
+| Variable | Purpose | Default |
+|---|---|---|
+| `DSH_MEMORY_SERVER_DIR` | directory containing `server.py` | `$DSH_HOME/memory-vault-server` |
+| `DSH_MEMORY_PATH` | vault directory (forwarded to the server as `MEMORY_PATH`) | `$DSH_HOME/memory-vault` |
+
+The bundle ships no cwd-dependent paths: the `cordis.patch.yml` layer resolves both
+values from the environment, falling back to the harness home (`$DSH_HOME`, or
+`~/.dsh`) — DSH does not chdir, so launching from any directory works.
+
+## Development
+
+```sh
+pnpm install
+pnpm build
+pnpm test
+```
+
+The bundle manifest (`dsh.bundle`) makes this package installable through the
+standard `dsh plugin add` flow; the patch layer lives in `cordis.patch.yml`.

package/cordis.patch.yml

@@ -0,0 +1,16 @@
+# bundle @luisarg/memory-mcp — MCP stdio wrapper for memory-vault
+# overrides vía env: DSH_MEMORY_PATH, DSH_MEMORY_SERVER_DIR
+# defaults resuelven bajo el home del harness (cwd-independent):
+#   $DSH_HOME/memory-vault-server y $DSH_HOME/memory-vault (~/.dsh por defecto)
+- insert:
+    - id: memory-mcp
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: memory
+        transport: stdio
+        command: uv
+        args: [run, --directory, !!js process.env.DSH_MEMORY_SERVER_DIR ?? dshHomePath('memory-vault-server'), python, server.py]
+        env:
+          MEMORY_PATH: !!js process.env.DSH_MEMORY_PATH ?? dshHomePath('memory-vault')
+          UV_CACHE_DIR: /tmp/uv-cache
+        cwd: !!js process.env.DSH_MEMORY_SERVER_DIR ?? dshHomePath('memory-vault-server')

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import Schema from "@deepseek-ai/schemastery";
+import { Context } from "@deepseek-ai/cordis";
+
+//#region src/index.d.ts
+declare const name = "memory-mcp";
+interface Config {
+  memoryPath: string;
+}
+declare const Config: Schema<Config>;
+declare function apply(ctx: Context, config: Config): void;
+//#endregion
+export { Config, apply, name };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;cAMa,IAAA;UAEI,MAAA;EAFJ,UAAI,EAAA,MAAA;AAEjB;AAIa,cAAA,MAAe,EAAP,MAAA,CAAO,MAAD,CAAA;AAcX,iBAAA,KAAA,CAAW,GAAiB,EAAjB,OAAuB,EAAA,MAAA,EAAN,MAAM,CAAA,EAAA,IAAA"}

package/dist/index.js

@@ -0,0 +1,26 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, join } from "node:path";
+import Schema from "@deepseek-ai/schemastery";
+
+//#region src/index.ts
+const name = "memory-mcp";
+const Config = Schema.object({ memoryPath: Schema.string().default(process.env.DSH_MEMORY_PATH ?? "") });
+/**
+* Resolve the harness home the same way the harness does (`$DSH_HOME`, or
+* `~/.dsh`). Paths must never depend on the launch cwd: DSH does not chdir.
+*/
+function resolveMemoryPath(value) {
+	const v = value.trim();
+	if (v.length === 0) return join(process.env.DSH_HOME?.trim() || join(homedir(), ".dsh"), "memory-vault");
+	return isAbsolute(v) ? v : join(process.env.DSH_HOME?.trim() || join(homedir(), ".dsh"), v);
+}
+function apply(ctx, config) {
+	const memoryPath = resolveMemoryPath(config.memoryPath);
+	if (!existsSync(memoryPath)) console.warn(`[memory-mcp] vault not found at ${memoryPath} — it will be created on first use.`);
+	console.log(`[memory-mcp] MEMORY_PATH=${memoryPath}`);
+}
+
+//#endregion
+export { Config, apply, name };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["Config: Schema<Config>"],"sources":["../src/index.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { isAbsolute, join } from 'node:path'\nimport type { Context } from '@deepseek-ai/cordis'\nimport Schema from '@deepseek-ai/schemastery'\n\nexport const name = 'memory-mcp'\n\nexport interface Config {\n  memoryPath: string\n}\n\nexport const Config: Schema<Config> = Schema.object({\n  memoryPath: Schema.string().default(process.env.DSH_MEMORY_PATH ?? ''),\n})\n\n/**\n * Resolve the harness home the same way the harness does (`$DSH_HOME`, or\n * `~/.dsh`). Paths must never depend on the launch cwd: DSH does not chdir.\n */\nfunction resolveMemoryPath(value: string): string {\n  const v = value.trim()\n  if (v.length === 0) return join((process.env.DSH_HOME?.trim() || join(homedir(), '.dsh')), 'memory-vault')\n  return isAbsolute(v) ? v : join(process.env.DSH_HOME?.trim() || join(homedir(), '.dsh'), v)\n}\n\nexport function apply(ctx: Context, config: Config) {\n  // This plugin is a placeholder; actual MCP wiring is via cordis.patch.yml\n  // dsh-mcp-client row. This module allows Config validation and logs.\n  const memoryPath = resolveMemoryPath(config.memoryPath)\n  if (!existsSync(memoryPath)) {\n    console.warn(`[memory-mcp] vault not found at ${memoryPath} — it will be created on first use.`)\n  }\n  console.log(`[memory-mcp] MEMORY_PATH=${memoryPath}`)\n}\n"],"mappings":";;;;;;AAMA,MAAa,OAAO;AAMpB,MAAaA,SAAyB,OAAO,OAAO,EAClD,YAAY,OAAO,QAAQ,CAAC,QAAQ,QAAQ,IAAI,mBAAmB,GAAG,EACvE,CAAC;;;;;AAMF,SAAS,kBAAkB,OAAuB;CAChD,MAAM,IAAI,MAAM,MAAM;AACtB,KAAI,EAAE,WAAW,EAAG,QAAO,KAAM,QAAQ,IAAI,UAAU,MAAM,IAAI,KAAK,SAAS,EAAE,OAAO,EAAG,eAAe;AAC1G,QAAO,WAAW,EAAE,GAAG,IAAI,KAAK,QAAQ,IAAI,UAAU,MAAM,IAAI,KAAK,SAAS,EAAE,OAAO,EAAE,EAAE;;AAG7F,SAAgB,MAAM,KAAc,QAAgB;CAGlD,MAAM,aAAa,kBAAkB,OAAO,WAAW;AACvD,KAAI,CAAC,WAAW,WAAW,CACzB,SAAQ,KAAK,mCAAmC,WAAW,qCAAqC;AAElG,SAAQ,IAAI,4BAA4B,aAAa"}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@luisarg/memory-mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "DSH MCP client for the memory vault",
+  "repository": { "type": "git", "url": "git+https://github.com/Luisarg03/dsh-memory-vault.git" },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": { ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" } },
+  "files": ["dist/", "cordis.patch.yml"],
+  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } },
+  "scripts": { "build": "tsdown", "dev": "tsdown --watch", "test": "vitest run --passWithNoTests", "prepare": "tsdown" },
+  "dependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/schemastery": "3.18.1"
+  },
+  "devDependencies": { "typescript": "^5.9.2", "tsdown": "^0.15.6" }
+}