Skip to content
dsh-market Browse plugins GitHub 中文

Luisarg03/dsh-memory-vault#memory-mcp

Bridges the agent to a persistent OKF memory vault over MCP stdio: a Python server (SQLite FTS5 + Markdown) with 10 tools for searching and storing decisions, facts, learnings, conventions, profiles and sources.

Stars ★ 0 Category Memory Listed 2026-08-31 npm @luisarg/memory-mcp

Install

Inside DeepSeek Harness, with dsh-market

dsh plugin --profile web add dshmarket

Or from the command line

dsh plugin --profile web add @luisarg/memory-mcp

Installing runs third-party code with your own permissions — it can read your files, use your credentials and reach the network. Review the source first, and pin a commit (github:owner/repo#sha) when you can.

README

Cordis bundle that connects 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

dsh plugin --profile web add @luisarg/memory-mcp

uv on PATH is recommended but not required: the bundled launcher.mjs runs the server with uv run when uv is present and falls back to a pip-managed venv (python3 -m venv + pip install -r requirements.txt, network on first boot) when it is not.

Skills

The package also ships the two skills that drive its tools, so installing it is enough to get the commands — nothing has to be copied into a skill directory:

Command Source What it does
/brain skills/brain/SKILL.md Reads the vault: topic search, recall by project, the profile, full exports — including the tool traps (entry_type=profile in search_memory always returns 0; tags are OR-matched; searches cap at 50)
/checkpoint skills/checkpoint/SKILL.md Captures the session as decision/fact/learning/convention entries, then commits the vault

They register at DSH's bundled rank (600), the weakest in the local discovery table, so a skill of the same name in a user or project root still wins. Each SKILL.md is the single source of its own name, description and usage guidance: the provider parses its frontmatter with yaml, so the same file also works copied into ~/.agents/skills. Registration goes through ctx.inject(['skills'], …), so a deployment with no skill catalog still gets the vault bootstrap and the MCP client.

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) ~/.memories

The bundle ships no cwd-dependent paths: the cordis.patch.yml layer resolves both values from the environment. The vault falls back to the OS home (~/.memories, which DSH_HOME does not move); the server to the harness home ($DSH_HOME, or ~/.dsh) — DSH does not chdir, so launching from any directory works.

Development

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.

Content from the project README on GitHub ↗

Comments

Comments live in GitHub Discussions. Sign in with GitHub to post or react.