前言¶

DeepSeek Harness (DSH) 的核心设计理念是插件化。在构建智能体或进行代码审查等任务时，经常需要将本地的知识图谱或代码记忆服务接入到 DSH 的上下文中。dsh-codebase-memory-mcp 插件解决了这一需求，它利用 DSH 内置的 @deepseek-ai/dsh-mcp-client 桥接层，将本地的 codebase-memory-mcp 知识图谱服务器直接连接到 DSH 环境中，无需开发者自行实现 MCP 传输层。

插件介绍¶

这是一个 DeepSeek Harness 插件，旨在将本地的 codebase-memory-mcp 知识图谱 MCP 服务器桥接到 DSH。它通过复用 DSH 内置的 @deepseek-ai/dsh-mcp-client，让模型能够直接调用代码库记忆相关的工具。

基本信息
* 项目名称：dsh-codebase-memory-mcp
* 作者：princeofdream
* 分类：记忆
* 许可证：MIT

核心功能¶

该插件提供以下核心能力：

1. 服务器桥接：将本地的 codebase-memory-mcp 知识图谱服务连接到 DSH。
2. 工具注册：
   • MCP 工具：注册了 14 个 mcp__codebase-memory__* 开头的 MCP 工具（如 index_repository, search_graph, trace_path, query_graph, detect_changes 等），供模型调用。
   • 宿主工具：注册了两个宿主级工具，用于监控和重启服务：
     • codebase_memory_status：查询服务状态。
     • codebase_memory_restart：重启服务。
3. 配置管理：提供 codebase-memory-mcp 命名空间，支持配置服务器可执行文件路径、工作目录、额外参数、环境变量及启用开关。

安装与启用¶

通过命令行安装插件：

dsh plugin --profile web add dsh-codebase-memory-mcp

安装完成后，需要重新加载 DSH Web 主机（重启应用或在应用内重载）以使插件生效。如果是本地开发环境，也可以使用 link: 协议指定本地路径进行安装。

配置与使用¶

检查服务状态¶

安装后，首先需要确认桥接是否正常工作。通过模型调用宿主工具 codebase_memory_status 查看状态。

codebase_memory_status

修复配置与重启¶

如果状态显示为 error，通常是因为可执行文件路径配置错误或环境问题。该插件不会因为二进制文件错误而崩溃，而是会记录日志。

请按以下步骤修复：

1. 进入 DSH 的设置文档，找到 codebase-memory-mcp 命名空间。
2. 检查并修正 exePath、cwd 或 env 配置项。
3. 保存设置（支持热重载，无需重启 DSH）。
4. 再次调用 codebase_memory_restart 重启桥接。

验证连接¶

当 codebase_memory_status 返回 state: "ready" 且 toolCount > 0 时，表示桥接成功，模型可以开始使用 mcp__codebase-memory__* 相关工具。

注意事项¶

1. 依赖要求：该插件依赖 DSH 内置的 @deepseek-ai/dsh-mcp-client 包。如果安装失败，请检查该依赖是否已正确引入。
2. GUI 卡片限制：配置界面的 GUI 卡片为尽力而为的特性，可能不会出现在所有的 DSH 构建版本中。如果在设置中找不到该卡片，仍可通过通用设置文档编辑器或直接修改配置文件来管理 codebase-memory-mcp 命名空间。
3. 错误处理：如果二进制文件不可用，插件不会崩溃，而是通过控制台日志记录错误，并允许通过宿主工具继续尝试修复。
4. 启动状态观察：可以通过控制台插件加载报告或 codebase_memory_status 工具观察启动状态。

总结¶

dsh-codebase-memory-mcp 为 DSH 提供了连接本地知识图谱的能力。通过内置的桥接逻辑和配置管理，开发者可以方便地将代码记忆服务集成到工作流中。在使用前，建议检查源码与许可证，并确保依赖已满足。

• GitHub 仓库：https://github.com/princeofdream/dsh-codebase-memory-mcp
• 社区目录：https://www.skillhub.cn/plugins/princeofdream/dsh-codebase-memory-mcp