john
938f6d6d37
Memind CI / Test, build, and release guards (push) Failing after 34s
Document the ~/.local/bin vs /opt/homebrew/bin mismatch that breaks MCP connection when install targets a path the global npm binary does not use. Co-authored-by: Cursor <cursoragent@cursor.com>
77 lines
2.5 KiB
Markdown
77 lines
2.5 KiB
Markdown
# codebase-memory-mcp 本地开发
|
||
|
||
> MIT · 仅本机 Cursor / code 任务开发工具 · **不进入 MeMind 103 运行时**
|
||
> 关联：[context-runtime-harness-fusion-plan.md](./context-runtime-harness-fusion-plan.md) §6.6
|
||
|
||
## 用途边界
|
||
|
||
| 允许 | 禁止 |
|
||
|------|------|
|
||
| Cursor 内代码库结构查询、调用链、架构图 | 个人生活流 / h5 用户记忆主检索 |
|
||
| 未来挂到 `tool-gateway` 的 aider/openhands 路径 | 替代 Memory V2 / Context Runtime Phase 2–3 |
|
||
| Phase 5 Personal KG **仅借 schema 思想** | 把索引目录提交进 Git |
|
||
|
||
## 安装（本机一次）
|
||
|
||
```bash
|
||
npm install -g codebase-memory-mcp
|
||
codebase-memory-mcp install -y # 写入 ~/.cursor/mcp.json 等，属设计行为
|
||
```
|
||
|
||
安装后 **重启 Cursor**。全局二进制缓存由 npm 包管理；图数据在 CBM 本地 daemon/SQLite，**不在** Memind 仓库根目录。
|
||
|
||
**Homebrew 路径**：若用 `brew`/全局 npm 安装，二进制通常在 `/opt/homebrew/bin/codebase-memory-mcp`。`install` 默认写 `~/.local/bin/...`，若该路径不存在会导致 Cursor MCP 连不上——确认 `~/.cursor/mcp.json` 的 `command` 与 `which codebase-memory-mcp` 一致。
|
||
|
||
## 首次索引 Memind
|
||
|
||
**方式 A — Cursor（推荐）**
|
||
|
||
重启后对 agent 说：**「Index this project」**。
|
||
|
||
**方式 B — CLI**
|
||
|
||
```bash
|
||
cd /Users/john/Project/Memind
|
||
codebase-memory-mcp cli --progress index_repository '{"repo_path":"/Users/john/Project/Memind"}'
|
||
```
|
||
|
||
可选：常驻 daemon 减少 CLI 冷启动：
|
||
|
||
```bash
|
||
codebase-memory-mcp daemon start
|
||
```
|
||
|
||
## 离线验证
|
||
|
||
```bash
|
||
codebase-memory-mcp --version
|
||
node scripts/check-codebase-memory-mcp-local.mjs
|
||
```
|
||
|
||
- 仅验证 CLI + Cursor 配置：`MEMIND_CBM_REQUIRE_INDEX=0 node scripts/check-codebase-memory-mcp-local.mjs`
|
||
- 完整通过需已索引，输出 **`CODEBASE_MEMORY_MCP_OK`**
|
||
|
||
## 常用 CLI 探针
|
||
|
||
```bash
|
||
codebase-memory-mcp cli --json list_projects '{}'
|
||
codebase-memory-mcp cli --json search_graph '{"name_pattern":".*headroom.*","label":"Function"}'
|
||
codebase-memory-mcp cli --json get_architecture '{}'
|
||
```
|
||
|
||
## 与 zvec-grep 的分工
|
||
|
||
| 工具 | 强项 |
|
||
|------|------|
|
||
| **codebase-memory-mcp** | AST 知识图：符号、CALLS、路由、Cypher |
|
||
| **zvec-grep** | workspace 语义/关键词文件检索（`.zvec-grep/`） |
|
||
|
||
两者互补；Context Runtime 本地清单见 [context-runtime-local-dev.md](./context-runtime-local-dev.md)。
|
||
|
||
## 卸载 / 更新
|
||
|
||
```bash
|
||
codebase-memory-mcp update
|
||
codebase-memory-mcp uninstall -y # 仅移除 agent MCP 配置，不删全局 npm 包
|
||
```
|