项目介绍
DevMind MCP
<div align="center">
面向AI助手的智能上下文感知记忆系统
English | 中文 | 📋 更新日志 | 🚀 最新发布
</div>为什么选择 DevMind MCP？
- 纯MCP工具 - 通过模型上下文协议与AI助手无缝集成
- 混合搜索 - 语义40% + 关键词30% + 质量20% + 新鲜度10%
- 100% 私有 - 所有数据本地存储在SQLite中，零云传输
- 14个MCP工具 - 完整的记忆管理和项目分析工具集
- 跨平台 - 支持Claude Desktop、Cursor以及所有兼容MCP的客户端
目录
概述
什么是 DevMind MCP？
DevMind MCP 通过模型上下文协议（MCP）为AI助手提供持久记忆能力。它使AI能够记住对话中的上下文，自动跟踪开发活动，并智能地检索相关信息。
主要特点
核心功能
- 基于类型的自动记忆 - 基于上下文类型简化智能记录
- 第1级：自动记录技术执行（修复错误、添加功能、修改代码）- 静默
- 第2级：带有通知的自动记录（解决方案、设计、文档）- 可删除
- 第3级：不自动记录（对话、错误）- 除非设置force_remember=true
- 智能记忆 - 通过MCP协议驱动的上下文记录
- 语义搜索 - 使用AI驱动的向量嵌入搜索来查找相关上下文
- 持久存储 - 基于SQLite的本地存储，完全隐私
- 混合搜索 - 结合关键词和语义搜索以获得最佳结果
- 实时响应 - 在开发过程中记录，即时检索
- 跨工具支持 - 兼容多个MCP客户端和开发环境
- 专业文档 - AI驱动的项目分析和DEVMIND.md生成
- 多语言支持 - 自动检测中文/英文文档的语言
- 统一会话 - 每个项目一个主要会话，保持一致的上下文
技术特性
- 完全符合MCP协议
- 统一会话管理（每个项目一个主要会话）
- 自动会话重新激活
- 可定制的存储路径和行为
- 高效处理数千个上下文
- 自动清理和内存优化
- 强大的错误处理和恢复
架构
┌──────────────────────────────────────────────────────────────┐
│ AI助手 │
│ (Claude Desktop / Cursor / 等) │
└────────────────────────┬─────────────────────────────────────┘
│ MCP协议（标准I/O）
▼
┌──────────────────────────────────────────────────────────────┐
│ DevMind MCP服务器 │
│ ┌─────────────────┐ ┌─────────────────┐ ┌──────────────││
│ │ 14个MCP工具 │ │ 基于类型的 │ │ 混合搜索 ││
│ │ │ │ 自动记忆 │ │ ││
│ │ • 会话 (4) │ │ │ │ • 语义 ││
│ │ • 上下文 (6) │ │ │ │ • 关键词 ││
│ │ • 项目 (2) │ │ • 3级 │ │ • 质量 ││
│ │ • 可视化 (1) │ │ • 智能类型 │ │ • 新鲜度 ││
│ │ • 状态 (1) │ │ • 懒惰评分 │ │ ││
│ └─────────────────┘ └─────────────────┘ └──────────────││
└────────────────────────┬─────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────┐
│ SQLite本地存储 │
│ 项目 • 会话 • 上下文 • 关系 • 嵌入式 │
│ + 自动生成的质量分数（每24小时懒惰更新） │
└──────────────────────────────────────────────────────────────┘
关键组件：
- 14个MCP工具 - 会话管理（4），上下文操作（6），项目功能（2），可视化（1），状态（1）
- 基于类型的自动记忆 - 简化的三级策略，基于上下文类型
- 混合搜索 - 多维评分：语义40% + 关键词30% + 质量20% + 新鲜度10%
- 本地存储 - SQLite数据库，包含向量嵌入和全文索引
项目结构
devmind-mcp/
├── src/
│ ├── mcp-server.ts # MCP协议服务器
│ ├── database.ts # SQLite存储引擎
│ ├── vector-search.ts # 使用嵌入式的语义搜索
│ ├── session-manager.ts # 会话及上下文管理
│ ├── content-extractor.ts # 代码分析及提取
│ ├── content-quality-assessor.ts # 内容质量评分
│ ├── quality-score-calculator.ts # 多维度质量评分
│ ├── auto-record-filter.ts # 智能去重
│ ├── context-file-manager.ts # 文件变更追踪
│ ├── types.ts # 类型定义
│ ├── index.ts # 主入口点
│ │
│ ├── memory-graph/ # 记忆图可视化
│ │ ├── index.ts # 主图生成器
│ │ ├── types.ts # 图类型定义
│ │ ├── data/
│ │ │ ├── GraphDataExtractor.ts # 数据从数据库中提取
│ │ │ ├── NodeBuilder.ts # 节点构建及标注
│ │ │ └── EdgeBuilder.ts # 边/关系构建
│ │ └── templates/
│ │ └── HTMLGenerator.ts # HTML可视化生成器
│ │
│ ├── utils/
│ │ ├── file-path-detector.ts # 智能文件检测
│ │ ├── git-diff-parser.ts # Git差异解析
│ │ ├── path-normalizer.ts # 跨平台路径处理
│ │ └── query-enhancer.ts # 搜索查询增强
│ │
│ └── project-indexer/
│ ├── index.ts # 项目分析器入口
│ ├── core/
│ │ └── ProjectMemoryOptimizer.ts
│ ├── strategies/
│ │ ├── SmartIndexingStrategy.ts
│ │ └── SecurityStrategy.ts
│ ├── tools/
│ │ ├── FileScanner.ts
│ │ ├── ContentExtractor.ts
│ │ └── ProjectAnalyzer.ts
│ └── types/
│ └── IndexingTypes.ts
│
├── dist/ # 编译输出
├── scripts/ # 维护脚本
└── docs/zh/ # 中文文档
快速开始
先决条件
- Node.js ≥ 20.0.0
- 兼容MCP的客户端 (Claude Desktop, Cursor等)
安装
选择适合您的方法：
| 方法 | 命令 | 最佳用途 | 自动更新 |
|---|---|---|---|
| NPX | npx -y devmind-mcp@latest | 快速测试，首次使用 | 是 |
| 全局安装 | npm install -g devmind-mcp | 日常开发 | 否 |
| 从源码 | git clone + npm install | 贡献，自定义 | 否 |
分步设置
步骤1：添加到MCP客户端
编辑您的MCP客户端配置文件：
配置文件位置：
- Windows:
C:\Users\<您的用户名>\.claude.json或%USERPROFILE%\.claude.json - macOS:
~/.claude.json - Linux:
~/.claude.json
添加以下配置：
{
"mcpServers": {
"devmind": {
"command": "npx",
"args": ["-y", "devmind-mcp@latest"]
}
}
}
使用全局安装？ 替换为：{"command": "devmind-mcp"}
步骤2：重启您的MCP客户端
重启Claude Desktop或您的MCP客户端以加载DevMind。
步骤3：尝试第一个命令
在您的AI助手中尝试：
"使用语义搜索找到关于身份验证的信息"
完成！ DevMind现在增强了您的AI助手，提供了持久记忆。
下一步
如何让AI使用DevMind
遵循这些步骤进行每次开发会话：
-
会话初始化
- 通过调用
get_current_session或让它自动创建开始 - 说“检查记忆...”并调用
list_contexts(limit: 5)
- 通过调用
-
开发期间
- 关键：在编辑文件后立即调用
record_context - 根据工作类型使用类型：bug_fix、feature_add、code_modify
- 内容必须是项目的语言（中文/英文）
- 关键：在编辑文件后立即调用
-
完成任务之前
- 在说“完成”或“完成”之前记录
- 对于多文件修改使用
files_changed
-
当用户询问历史时
- 使用
语义搜索进行智能查询 - 使用
list_contexts按时间顺序浏览 - 使用
get_context查看完整详情
- 使用
使用指南
MCP工具快速参考
DevMind 提供了14个强大的工具和1个专业提示供您的AI助手使用：
项目分析
| 工具 | 目的 | 示例用法 |
|---|---|---|
project_analysis_engineer | [主要]综合项目分析 | 生成DEVMIND.md文档 |
注意：此工具也可作为手动触发的提示使用。
项目管理
| 工具 | 目的 | 示例用法 |
|---|---|---|
list_projects | [推荐]列出所有项目及其统计信息 | 概览已跟踪的项目 |
会话管理
| 工具 | 目的 | 示例用法 |
|---|---|---|
create_session | 开始新的开发会话 | 开始新功能 |
get_current_session | 获取当前会话信息 | 检查当前上下文 |
end_session | 结束开发会话 | 完成工作 |
delete_session | 删除会话及其所有上下文 | 清理旧会话 |
注意：DevMind 自动管理每个项目的主会话。会话在需要时自动创建并在对话之间重新激活。
上下文操作
|| 工具 | 目的 | 示例用法 |
||------------------|-----------------------------|------------------------|
|| record_context | 存储开发上下文 | 保存bug修复方案 |
|| list_contexts | 列出所有上下文 | 回顾项目历史 |
|| delete_context | 删除特定上下文 | 删除过时信息 |
|| update_context | 更新上下文内容/标签 | 完善文档 |
搜索与发现
|| 工具 | 目的 | 示例用法 |
||-------------------|-------------------------------|------------------------------|
|| semantic_search | AI驱动的语义搜索 | 查找相关实现 |
|| get_context | 通过ID获取上下文(s) | 查看完整的记忆内容 |
注意：在record_context时自动生成嵌入式。质量分数在搜索时每24小时自动更新一次（懒惰加载）。
可视化
| 工具 | 目的 | 示例用法 |
|---|---|---|
export_memory_graph | 导出交互式时间线图（v1.19） | 在垂直时间线上可视化记忆，具有6列类型 |
v1.19新增：记忆图具有干净的垂直时间线布局，固定节点定位和优化性能。
使用示例
存储上下文信息
// 存储开发上下文
await record_context({
content: "使用JWT令牌和刷新令牌支持实现了用户认证",
type: "实现",
tags: ["认证", "JWT", "安全", "API"]
});
搜索和检索
// 查找相关的上下文
const results = await semantic_search({
query: "我们是如何实现认证的？",
limit: 10
});
更新现有上下文
// 更新上下文的新信息
await update_context(contextId, {
content: "更新认证以支持OAuth2和SAML",
tags: ["认证", "JWT", "OAuth2", "SAML", "安全"]
});
上下文搜索
// 在特定时间段内搜索
const results = await semantic_search({
query: "数据库优化",
timeRange: { days: 7 }
});
专业文档生成
概述
DevMind 的项目分析工程师使用AI自动分析您的代码库并生成全面的专业文档。这种强大的提示驱动方法比传统的静态分析提供了更深入的见解。
主要特点
- AI驱动的分析 - 深入理解代码模式、架构和业务逻辑
- 多语言支持 - 自动检测并生成中文或英文文档
- 专业质量 - 生成具有技术深度的DEVMIND.md格式文档
- 自动保存到记忆 - 文档自动保存到项目的记忆中，以便将来参考
- 可定制的关注点 - 目标特定领域如架构、API、业务逻辑或安全性
- 多种格式 - 支持DEVMIND.md、技术规范和README格式
工作原理
项目扫描 → 代码分析 → AI处理 → 专业文档 → 记忆存储
│ │ │ │ │
智能文件 提取技术 生成深度 创建DEVMIND.md 自动保存到
选择 见解 分析 文档 可搜索数据库
使用
自然语言生成
英文：
- "为这个项目生成专业的DevMind文档"
- "创建全面的技术分析，使用DEVMIND.md格式"
- "分析这个代码库并生成专业文档"
中文：
- "为这个项目生成专业的DevMind文档"
- "创建全面的技术分析，使用DEVMIND.md格式"
- "分析这个代码库并生成专业文档"
直接提示使用
// 英文文档
const analysis = await project_analysis_engineer({
project_path: "./my-project",
doc_style: "devmind",
language: "en"
});
// 中文文档（自动检测）
const analysis = await project_analysis_engineer({
project_path: "./chinese-project",
doc_style: "devmind",
language: "zh"
});
配置
基本配置
在项目根目录创建.devmind.json：
{
"database_path": "~/.devmind/memory.db",
"max_contexts": 1000,
"search_limit": 20,
"auto_cleanup": true,
"vector_dimensions": 1536
}
配置选项
| 选项 | 类型 | 默认值 | 描述 |
|---|---|---|---|
database_path | 字符串 | ~/.devmind/memory.db | SQLite数据库文件位置 |
max_contexts | 数字 | 1000 | 最大存储上下文 |
search_limit | 数字 | 20 | 默认搜索结果限制 |
auto_cleanup | 布尔值 | true | 启用旧上下文的自动清理 |
vector_dimensions | 数字 | 1536 | 向量嵌入维度 |
智能记录指南
DevMind 使用**