obsidian-dev-memory 1.0.0

三层知识架构 MCP Server — 规范手册 + 知识网络 + 原始资料，越用越智能的开发知识库

Dev Memory — 本地开发知识复利 MCP Server

让 AI 记住你的每一次经验。解决问题后一句话存储，下次遇到类似问题时 AI 自动检索。越用越聪明，实现知识复利。

一键接入（30 秒）

方式一：uvx 零安装（推荐）

不需要预装任何东西，直接在 AI IDE 配置中使用：

Claude Code:

claude mcp add dev-memory -- uvx dev-memory-mcp

Cursor — 编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "dev-memory": {
      "command": "uvx",
      "args": ["dev-memory-mcp"]
    }
  }
}

方式二：pipx 全局安装

pipx install dev-memory

然后配置 AI IDE：

{
  "mcpServers": {
    "dev-memory": {
      "command": "dev-memory-mcp"
    }
  }
}

方式三：pip 安装

pip install dev-memory

方式四：一键脚本（自动检测 + 自动配置 IDE）

curl -fsSL https://raw.githubusercontent.com/Frankly666/dev-memory/main/install.sh | bash

脚本会自动检测环境、安装工具、配置 AI IDE。

方式五：从源码安装

git clone https://github.com/franklynxu/dev-memory.git
cd dev-memory
pip install -e .

---

支持的 AI IDE

IDE	配置方式
Claude Code	claude mcp add dev-memory -- uvx dev-memory-mcp
Cursor	~/.cursor/mcp.json
CodeBuddy	MCP 设置面板
Windsurf	MCP 设置面板
其他 MCP 客户端	stdio 协议通用接入

详细配置步骤见 MCP_SETUP.md

---

提供的 MCP Tools

v2 新增（推荐使用）

工具	功能	说明
ingest_knowledge	智能存储知识	搜索→判重→决策（新建/更新/合并）→维护关联
store_reference	存储原始资料	严格保留原文，AI 注解与原文分区
get_rules	获取工作规范	加载 RULES.md + taxonomy.yaml
update_rules	更新工作规范	用户和 AI 共同维护规范
update_knowledge	更新知识条目	追加方案、调整成熟度/置信度
get_hub	获取主题聚合页	查看某主题下的知识导航
evolve_knowledge	触发知识演化	归纳 concept、更新 hub

保留的 v1 Tools

工具	功能	说明
memorize	记忆开发经验	内部已升级为智能判重（兼容 v1）
search_knowledge	语义搜索知识库	增强：返回关联上下文
list_tags	列出知识标签	标签分布和频次
get_profile	开发者画像	技术偏好分析
sync_vault	同步索引	增量/全量同步
get_stats	知识库统计	含原始资料和规范状态

---

使用示例

安装后，直接在 AI IDE 中自然语言对话：

你: 帮我记住刚才解决的 Docker DNS 问题
AI: ✅ 已记忆「Docker 容器 DNS 解析失败」，标签: docker, dns, 网络

你: 之前有遇到过 K8s Pod 重启的问题吗？
AI: 找到 3 条相关经验：
    1. K8s Pod CrashLoopBackOff 排查 (相关度: 0.89)
    2. 容器 OOMKilled 内存泄漏排查 (相关度: 0.76)
    ...

你: 分析一下我的开发风格
AI: 你主要关注后端基础设施，技术栈以 Go + Docker + K8s 为主...

---

前置要求

1. Python 3.10+
2. Obsidian（桌面端，用于存储知识）
3. Obsidian Local REST API 插件（可选，提供更好的搜索体验）

首次初始化

# 初始化知识库（指定你的 Obsidian Vault 路径）
dev-memory init --vault-path /path/to/your/obsidian/vault

# 可选：配置 Obsidian API 密钥
dev-memory init --vault-path /path/to/vault --api-key YOUR_API_KEY

配置文件保存在 ~/.dev-memory/config.yaml，可随时编辑。

CLI 命令

除 MCP 接口外，也可通过命令行直接使用：

dev-memory add --title "解决XX问题" --problem "描述" --solution "方案"
dev-memory search "React 闭包问题"
dev-memory sync          # 同步索引
dev-memory profile       # 开发者画像
dev-memory stats         # 统计信息

---

架构

AI IDE (Claude Code / Cursor / CodeBuddy)
    │ stdio (MCP 协议)
    ▼
┌──────────────────────────────────────┐
│ Dev Memory MCP Server v2             │
│ (13 个 MCP Tools)                    │
├──────────────────────────────────────┤
│ 第一层: 规范手册层                     │
│   RulebookManager                    │
│   RULES.md + taxonomy.yaml           │
├──────────────────────────────────────┤
│ 第二层: 知识网络层                     │
│   KnowledgeEngine                    │
│   搜索→判重→决策→关联→归纳            │
│   solutions/ + concepts/ + _hubs/    │
├──────────────────────────────────────┤
│ 第三层: 原始资料层                     │
│   ReferenceManager                   │
│   原文存储 + AI 注解 + 溯源链         │
│   references/                        │
├──────────────────────────────────────┤
│ 基础设施: Obsidian + ChromaDB         │
└──────────────────────────────────────┘

开发

git clone https://github.com/franklynxu/dev-memory.git
cd dev-memory
pip install -e ".[dev]"
pytest

License

MIT