用 Neo4j Relate 给 Agent 装一个可查询的图记忆库：安装验签、Cypher 建图、.rl 持久化与只读 MCP 接入实操

# 新建练习目录，避免污染真实仓库
mkdir relate-demo && cd relate-demo

# 先审阅远端安装脚本（浏览器打开也行）
curl -sSfL https://relatedb.ai/install.sh | less

# 确认无误后再执行；脚本校验签名与 SHA256 后装到 ~/.local/bin
curl -sSfL https://relatedb.ai/install.sh | bash

# 如果新开终端找不到命令，把安装目录加进 PATH
export PATH="$HOME/.local/bin:$PATH"

# 官方安装文档索引，逐页可加 .md 取纯文本
# https://relatedb.ai/docs/llms.txt

# 期望首行形如 Relate v1.0.1，后面跟许可文本属正常
relate --version

# 给人看的表格输出（终端默认也是表格）
relate --mode table "RETURN 1 AS ok"

# 给 Agent / 程序看的 envelope：列名与列类型都在，空结果也不会变成空输出
relate --mode envelope "RETURN 1 AS ok"
# {"columnTypes":["INTEGER"],"columns":["ok"],"notifications":[],
#  "rows":[{"ok":1}],"truncated":false,...}

cat > seed.cypher <<'EOF'
CREATE (ada:Person {name: 'Ada', role: 'engineer'}),
       (grace:Person {name: 'Grace', role: 'engineer'}),
       (noor:Person {name: 'Noor', role: 'maintainer'}),
       (relate:Project {name: 'relate', language: 'Rust'}),
       (tck:Project {name: 'opencypher-tck', language: 'Gherkin'}),
       (ada)-[:WORKS_ON {since: 2024}]->(relate),
       (grace)-[:WORKS_ON {since: 2023}]->(relate),
       (grace)-[:WORKS_ON {since: 2022}]->(tck),
       (noor)-[:MAINTAINS]->(relate),
       (ada)-[:KNOWS]->(grace);
MATCH (n) RETURN count(n) AS nodes;
EOF

# relate query 从标准输入读脚本，--database 指向尚不存在的文件时会自动创建
relate query --database ./team.rl --mode table < seed.cypher

# 目录里应当只有脚本与一个库文件
ls

# 只读查询：谁从哪一年起参与哪个项目
relate --database ./team.rl --read-only --mode table "MATCH (p:Person)-[w:WORKS_ON]->(proj:Project) RETURN p.name AS person, proj.name AS project, w.since AS since ORDER BY since"

# 值用参数绑定，单引号防止 shell 把 $name 吃掉
relate --database ./team.rl --read-only --mode table --param name=Grace 'MATCH (:Person {name: $name})-[:WORKS_ON]->(proj:Project) RETURN proj.name AS project, proj.language AS language ORDER BY project'

# EXPLAIN 只出计划不执行，顺带看索引建议
relate --database ./team.rl --read-only --mode table "EXPLAIN MATCH (p:Person)-[:WORKS_ON]->(proj:Project {name: 'relate'}) RETURN p.name AS person ORDER BY person"

# 机器可读输出，便于脚本断言
relate --database ./team.rl --read-only --mode envelope --param name=Zed 'MATCH (:Person {name: $name})-[:WORKS_ON]->(proj:Project) RETURN proj.name AS project ORDER BY project LIMIT 10'

# 只给 Claude Code 装；官方列出的可选宿主还有
# cursor / windsurf / copilot / antigravity / gemini-cli / cline / codex / pi / opencode / junie
relate skill install --agent claude-code

# 打印当前安装版本的命令索引、旗标与退出码，让 Agent 读它而不是猜
relate agent-context

# 需要按需装任务技能时，官方索引给出的形式是
npx skills add https://relatedb.ai --skill <name>

# 升级前先只检查，不改变任何东西
relate upgrade --check
relate upgrade

# 在项目根写 .mcp.json（Claude Code）
{
  "mcpServers": {
    "relate": {
      "command": "relate",
      "args": ["serve", "--mcp", "stdio", "--database", "./team.rl", "--read-only"]
    }
  }
}

# 等价的命令行注册方式
claude mcp add relate -- relate serve --mcp stdio --database ./team.rl --read-only

# 不依赖宿主，直接把 JSON-RPC 消息喂给 stdio 服务验工具清单
printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"shell","version":"0"}}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
  | relate serve --mcp stdio --database ./team.rl --read-only 2>/dev/null

# 若宿主只吃 URL，改起端口：默认绑 127.0.0.1，需凭据
relate serve --mcp 8000 --database ./team.rl --read-only