Claude Code  ──MCP──>  Vault MCP Server  ──SQLite──>  ~/vault/ (.md 笔记文件)
    |                       |
    |  /kb 路由指令          ├── vault_init/save/search/resume/list/stats/orphan/update/tags/log
    |  (~/.claude/skills/    └── graphify_build/status/query
    |   kb.md)
    |
    └── (可选) Obsidian 客户端 ──> 知识图谱可视化浏览

pip install mcp>=1.0.0
# graphify 为可选依赖，用于代码图谱功能
pip install graphifyy

PYTHONIOENCODING=utf-8 python ~/scripts/vault-mcp-server/server.py

{
  "mcpServers": {
    "vault": {
      "command": "python",
      "args": [
        "~/scripts/vault-mcp-server/server.py"
      ],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

# Windows
powershell -ExecutionPolicy Bypass -File release/install.ps1

# Linux/macOS
bash release/install.sh

claude mcp list

# 对 Claude Code 说
初始化知识库

# 或指定项目目录
/kb init --project myproject

用户: "git push 总是失败，报 permission denied"

Claude 排查并解决问题...

用户: "把这个解决方案保存到知识库"

用户: "之前那个 Windows 下 subprocess 编码问题的解决方案还在吗？"

# 或直接用命令
/kb search Windows subprocess 编码

{
  "status": "ok",
  "query": "Windows subprocess 编码",
  "count": 3,
  "results": [
    {
      "title": "Windows Python subprocess 乱码解决方案",
      "snippet": "...设置 <b>PYTHONIOENCODING</b>=utf-8...",
      "tags": ["windows", "python", "encoding"],
      "type": "solution",
      "score": 0.87
    }
  ]
}

用户: "继续昨天 myproject 的工作"

# 或
/kb resume myproject

~/scripts/vault-mcp-server/
├── server.py                  # MCP 入口，注册 13 个工具，stdio 通信
├── db.py                      # SQLite 数据库层 (VaultDB 类)
├── requirements.txt           # mcp>=1.0.0, graphifyy (可选)
├── tools/
|   ├── __init__.py
|   ├── _shared.py             # 公共工具: 输入校验、JSON 回复、路径处理
|   ├── vault_tools.py         # 10 个核心 + 管理工具实现
|   └── graphify_tools.py      # 3 个代码图谱工具实现
└── tests/                     # 单元/集成/E2E 测试（228）

~/vault/                       # Obsidian Vault 根目录
├── CLAUDE.md                  # Vault 使用规则（笔记规范 + 三层查询策略）
├── permanent/                 # 永久知识笔记 (type: permanent/solution/concept)
├── templates/
|   ├── default-note.md        # 通用笔记模板
|   └── session-log.md         # 会话日志模板
├── logs/                      # 全局会话日志 (type: session-log)
├── <project>/                 # 项目笔记（每个项目一个子目录）
|   ├── architecture/          # 架构设计、概念笔记 (type: permanent/concept)
|   ├── features/              # 功能方案、问题解决 (type: solution)
|   ├── data/                  # 数据模型、工具技巧 (type: tool)
|   └── logs/                  # 项目会话日志 (type: session-log)
└── graphify/                  # 代码图谱笔记
    └── <project>/
        ├── Index.md           # 图谱索引
        └── Community-*.md     # 按社区（模块）分类的代码笔记

~/.claude/
├── skills/
│   └── kb/
│       └── SKILL.md            # /kb 路由指令
└── .claude.json                # 用户级配置（含 MCP servers）

pip install graphifyy

# 查看 graphify 安装位置
pip show graphifyy | grep Location

# 检查 Python 版本 (需要 3.10+)
python --version

# 检查 mcp 包是否安装
pip show mcp

# 手动启动测试
python C:/Users/Gzlance/scripts/vault-mcp-server/server.py
# 如果无报错退出，说明 MCP stdio 正常启动