MCP 记忆库服务器 🧠

一个强大的，为大型语言模型 (LLMs) 打造的上下文管理系统。它基于 ChromaDB 和现代嵌入技术构建，提供持久的、项目特定的记忆能力，从而增强您 AI 的理解和响应质量。

✨ 主要特性

• 🚀 高性能: 使用 ChromaDB 优化的向量存储
• 🔒 项目隔离: 为不同项目提供独立的上下文空间
• 🔍 智能搜索: 具备语义和关键词搜索能力
• 🔄 实时更新: 通过自动分块实现动态内容管理
• 🎯 精确召回: 通过 @xenova/transformers 实现高级嵌入生成
• 🐳 易于部署: Docker 就绪，具备持久化存储

🏗️ 系统架构

graph TB
    Client[客户端应用]
    MCP[MCP 协议层]
    Tools[工具注册]
    PS[项目服务]
    ES[嵌入服务]
    SS[搜索服务]
    DS[数据库服务]
    ChromaDB[(ChromaDB)]
    
    Client -->|API 调用| MCP
    MCP -->|注册| Tools
    Tools -->|项目操作| PS
    Tools -->|搜索操作| SS
    PS -->|存储/检索| DS
    SS -->|查询| DS
    SS -->|生成| ES
    DS -->|向量操作| ChromaDB
    
    subgraph 核心服务
        PS
        ES
        SS
        DS
    end
    
    subgraph 外部依赖
        ChromaDB
    end
    
    style Client fill:#f9f,stroke:#333,stroke-width:2px
    style MCP fill:#bbf,stroke:#333,stroke-width:2px
    style ChromaDB fill:#bfb,stroke:#333,stroke-width:2px
    style 核心服务 fill:#fff,stroke:#333,stroke-width:2px,stroke-dasharray: 5 5

🚀 快速开始

前提条件

• Node.js (推荐 v18+ LTS)
• npm (推荐 v9+)
• Docker Desktop (最新稳定版)
• 2GB+ 可用 RAM
• 1GB+ 可用磁盘空间

一键安装

# 克隆，安装，并在开发模式下运行
git clone https://github.com/your-org/mcp-memory-bank.git && cd mcp-memory-bank && npm install && docker-compose up -d && npm run dev

🔄 项目生命周期

stateDiagram-v2
    [*] --> ProjectCreation: memoryBank_createProject
    ProjectCreation --> Initialization: memoryBank_initializeProject
    
    state Initialization {
        [*] --> CreateStandardFiles
        CreateStandardFiles --> ProjectBrief: projectbrief.md
        CreateStandardFiles --> ActiveContext: activeContext.md
        CreateStandardFiles --> ProductContext: productContext.md
        CreateStandardFiles --> SystemPatterns: systemPatterns.md
        CreateStandardFiles --> TechContext: techContext.md
        CreateStandardFiles --> Progress: progress.md
    }
    
    Initialization --> ContentManagement
    
    state ContentManagement {
        [*] --> FileOperations
        FileOperations --> UpdateFile: memoryBank_updateFile
        FileOperations --> GetFile: memoryBank_getFile
        FileOperations --> ListFiles: memoryBank_listFiles
        FileOperations --> DeleteFile: memoryBank_deleteFile
        
        state Search {
            [*] --> SemanticSearch
            [*] --> KeywordSearch
        }
        
        FileOperations --> Search: memoryBank_search
    }
    
    ContentManagement --> ProjectDeletion: memoryBank_deleteProject
    ProjectDeletion --> [*]

📚 API 文档

核心工具

项目管理

• memoryBank_createProject: 创建隔离的项目空间
• memoryBank_initializeProject: 在项目中创建标准的记忆库文件
• memoryBank_deleteProject: 清理项目数据
• memoryBank_listProjects: 查看所有项目
• memoryBank_getProjectByName: 获取项目详情

内容管理

• memoryBank_updateFile: 存储/更新内容，自动分块
• memoryBank_getFile: 检索完整内容
• memoryBank_listFiles: 查看存储的文件
• memoryBank_deleteFile: 删除内容
• memoryBank_search: 语义/关键词搜索

🔧 配置

环境变量

CHROMADB_URL=http://localhost:8000
MCP_MEMBANK_EMBEDDING_MODEL=Xenova/all-MiniLM-L6-v2
# 可选: 控制日志详细程度。默认为 'info'。
# 可选值: 'debug', 'info', 'warn', 'error'
LOG_LEVEL=info

🐛 故障排除

常见问题

1. ChromaDB 连接失败

   # 检查容器是否正在运行
   docker ps | grep chroma
   # 如果需要，重启
   docker-compose restart
   

2. 内存问题

   • 确保 Docker 有足够的内存分配
   • 考虑减少大量操作中的批处理大小

🤝 贡献

1. Fork 仓库
2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

📈 性能考量

• 向量运算随嵌入维度而扩展
• 批量操作以获得更好的吞吐量
• 使用适当的块大小 (默认: 512 tokens)
• 考虑对大型数据集进行索引优化

📄 许可证

本项目基于 MIT 许可证 - 详情请查看 LICENSE 文件。

---

用 ❤️ 构建 by bsmi021