Chroma MCP Server

Chroma MCP 服务

一个面向 Chroma（开源嵌入数据库）的 Model Context Protocol (MCP) 服务集成。

概述

Chroma MCP 服务为 AI 辅助开发创建一个持久、可搜索的“工作记忆”：

• 自动上下文召回： AI 助手可以查询过往会话中的相关信息
• 开发者管理的持久化： 通过 MCP 将关键决策和洞察存储到 ChromaDB
• 第二大脑集成： 与 IDE 工作流集成，打造统一的知识中心

主要特性：

• 自动化代码库索引： 跟踪并索引代码变更
• 自动化聊天记录： 记录 AI 交互，并增强上下文捕获（代码 diff、工具调用序列）
• 双向链接： 将讨论与代码变更关联起来，以追踪功能的演进过程
• 语义化代码分块： 保留逻辑代码结构，以实现更有意义的上下文检索
• 工作记忆工具： 用于捕获和检索开发上下文的 MCP 命令
• 验证系统： 对代码变更和学习提升进行基于证据的验证
• 自动化测试驱动学习： 从测试失败到验证修复并提升学习的全自动工作流。请参阅 Pytest 插件使用指南，将此功能集成到你的项目中。

更多详情请参阅第二大脑入门指南。

快速开始

安装

# Basic installation
pip install chroma-mcp-server

# Full installation with all embedding models
pip install "chroma-mcp-server[full]"

运行

# With in-memory storage (data lost on restart)
chroma-mcp-server --client-type ephemeral

# With persistent storage
chroma-mcp-server --client-type persistent --data-dir ./my_data

Cursor 集成

在项目根目录中添加或修改 .cursor/mcp.json：

{
  "mcpServers": {
    "chroma": {
      "command": "uvx",
      "args": [
        "chroma-mcp-server"
      ],
      "env": {
        "CHROMA_CLIENT_TYPE": "persistent",
        "CHROMA_DATA_DIR": "/path/to/your/data",
        "CHROMA_LOG_DIR": "/path/to/your/logs",
        "LOG_LEVEL": "INFO",
        "MCP_LOG_LEVEL": "INFO",
        "MCP_SERVER_LOG_LEVEL": "INFO"
      }
    }
  }
}

近期改进

• 增强的上下文捕获： 自动提取代码 diff、工具调用序列，并赋予置信度评分
• 双向链接： 在聊天讨论与代码变更之间创建可导航的连接
• 语义化代码分块： 使用逻辑边界（函数、类）而非固定大小的分块
• 服务端时间戳强制： 确保所有集合中的时间戳一致
• 自动创建集合： 服务启动时会自动创建必要的集合（例如 chat_history_v1、codebase_v1），如果它们尚不存在。
• 增强的日志系统： 按执行生成日志文件，防止在 stdio 模式下污染 JSON 通信
• 嵌入函数管理： 提供在更改嵌入函数时更新集合元数据的工具
• 集合设置命令： 简化以一致配置创建多个集合的过程
• 自动提升工作流： 简化派生学习的提升流程，自动处理高置信度条目
• 智能默认值： 交互式提升，根据上下文为所有字段提供智能默认值
• 低置信度警告： 对可能需要更仔细审查的条目提供可视化指示
• 自动化测试工作流： 全自动捕获测试失败、监控修复并验证学习提升

文档

完整文档位于 docs 目录：

• 主文档 - 安装、配置和使用的完整指南
• 快速开始 - 详细的设置说明
• 开发者指南 - 面向贡献者和开发者
• IDE 与工具集成指南 - 与 IDE 及其他工具集成的指南。
• 自动化聊天记录 - 通过双向链接丰富聊天历史
• 使用指南 - 关于如何使用特定功能和工作流的详细指南。
• 增强的上下文捕获 - 关于代码差异提取和工具排序的详细信息
• 语义代码分块 - 保留逻辑的代码分块，以实现有意义的检索
• 自动化测试工作流（Pytest 插件用法） - 通过自动验证进行测试驱动学习
• 思维工具与实用程序 - 结构化思维和记忆工具的文档。
• 客户端与开发者脚本 - 命令行工具和开发者脚本的指南。
• 日志记录文档 - 日志记录功能和配置概述。
• 服务端日志记录 - 改进后的日志记录系统详情
• 自动化文档 - 自动化开发任务的指南。
• 项目规则与准则 - 开发规则、准则和最佳实践。
• 重构计划 - 关于各项重构工作和架构计划的文档。
• API 参考 - 可用的 MCP 工具和参数

许可证

Chroma MCP Server 采用带 Commons Clause 的 MIT 许可证授权。这意味着你可以：

✅ 允许：

• 将 Chroma MCP Server 用于任何目的（个人、商业、学术）
• 修改代码
• 分发副本
• 创建并销售使用 Chroma MCP Server 构建的产品

❌ 不允许：

• 销售 Chroma MCP Server 本身
• 将 Chroma MCP Server 作为托管服务提供
• 基于 Chroma MCP Server 创建竞争产品

有关完整许可证文本，请参阅 LICENSE.md 文件。