mtm-codebase-memory
用于 codebase-memory-mcp 的 DeepSeek Harness 集成
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add mtm-codebase-memory@0.2.2Mtm Codebase Memory 以 mtm-codebase-memory 发布，当前版本为 0.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A source-loadable DeepSeek Harness integration for the local codebase-memory-mcp runtime.
The package exports a named Cordis plugin and a DSH profile bundle. Both paths use the same runtime implementation:
The model-facing tool namespace defaults to mcp__codebase_memory__*.
Install the bundle into the official local DSH web profile:
dsh plugin --profile web add mtm-codebase-memory
The bundle itself is installed into that profile; the native runtime is provisioned lazily by the package-owned npm CLI, so no global npx or codebase-memory-mcp command is required. A fresh DSH host is required after changing profile composition:
dsh --profile web --dump-config
The dump should contain a row named mtm-codebase-memory whose plugin name is also mtm-codebase-memory, not the old direct MCP-client row.
For a local checkout:
dsh plugin --profile web add /path/to/mtmdsh/packages/mtm-codebase-memory
The package can be loaded without a profile patch when a custom local DSH composition owns its plugin list:
import * as CodebaseMemory from "mtm-codebase-memory";
await ctx.plugin(CodebaseMemory, {
serverName: "codebase_memory",
});
The plugin requires the DSH systemPrompt and local subprocess services. Its nested official MCP client requires the normal DSH tools and model services.
All fields are optional:
| Field | Default | Purpose |
|---|---|---|
| serverName | codebase_memory | Stable MCP tool namespace |
| command / args | package-owned npm exec | Override the local executable for a controlled test or installation |
| cwd | DSH process cwd | Working directory for CBM and hook payloads |
| env | empty | Explicit CBM environment entries |
| cacheDir | unset | Sets CBM_CACHE_DIR |
| allowedRoot | unset | Sets CBM_ALLOWED_ROOT |
| ensureRuntime | true | Provision/resolve the native binary before MCP activation; false requires an offline cached runtime |
| augmentHooks | true | Enable session and read/search context augmentation |
| failOnStartupError | false | Use the official MCP client's startup failure policy |
| toolCallTimeoutMs | 60000 | MCP tool-call timeout |
| hookTimeoutMs | 2000 | Bounded hook-augment timeout |
| runtimeCheckTimeoutMs | 120000 | Binary provisioning/version-check timeout |
The shipped cordis.patch.yml supplies only the stable namespace. To override a row in a profile patch, restate the complete plugin config because DSH patch layers replace, rather than deep-merge, a matched row.
Example:
- id: mtm-codebase-memory
name: mtm-codebase-memory
config:
serverName: codebase_memory
allowedRoot: !!js process.cwd()
env:
CBM_LOG_LEVEL: warn
Do not put credentials in the patch. DSH's subprocess and MCP layers apply their normal environment scrubbing; explicit values in env are intentional opt-ins.
The plugin owns the current DSH-side frontend connection through Cordis. The native CBM runtime continues to own its shared daemon, watcher, indexes, and cache lifecycle. The plugin registers graph-first instructions in DSH system-prompt assembly and may add bounded CBM lifecycle context on the first step. Search/read tool events are translated to CBM's documented hook payload and any returned context is attached through DSH's logged tools/post-execute additional-context contract.
The integration does not run CBM's global codebase-memory-mcp install command. That command edits other agent clients' configuration files; DSH profile composition is the authority for this integration. The package-owned npm CLI is invoked only for the pinned package and native runtime provisioning.
In a fresh session:
From the repository root:
pnpm check:mtm-codebase-memory
pnpm --filter mtm-codebase-memory pack --pack-destination dist/npm
node scripts/verify-package.mjs packages/mtm-codebase-memory dist/npm/mtm-codebase-memory-0.2.2.tgz
pnpm run smoke:mtm-codebase-memory -- dist/npm/mtm-codebase-memory-0.2.2.tgz
Set DSH_SMOKE_TOOL_CATALOG=1 for the optional live-session assertion that checks mcp__codebase_memory__list_projects in the model tool catalog. This check requires a working DSH model route.
This package targets the official local Node DSH Web Harness. It does not provide a Cloudflare Worker or remote multi-tenant execution plane. The native CBM runtime must remain on the local execution host.
