Chroma MCP 服务器

一个用于 Chroma（开源嵌入式数据库）的模型上下文协议（MCP）服务器集成。

概述

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

• 自动上下文回忆： AI助手可以从过去的会话中查询相关信息。
• 开发者管理的持久性： 通过MCP在ChromaDB中存储关键决策和见解。
• 第二大脑集成： 与IDE工作流程集成，创建统一的知识中心。

主要特性：

• 自动代码库索引： 跟踪并索引代码更改。
• 自动聊天日志记录： 记录AI交互，增强上下文捕获（代码差异、工具序列）。
• 双向链接： 将讨论连接到代码更改，以追踪功能演变。
• 语义代码分块： 保存逻辑代码结构，以便更有意义地检索上下文。
• 工作记忆工具： 使用MCP命令捕捉和检索开发上下文。
• 验证系统： 基于证据的验证系统，用于代码更改和学习提升。
• 自动化测试驱动学习： 从测试失败到验证修复和学习提升的完全自动化工作流。参见 Pytest 插件使用指南，将其集成到您的项目中。

更多详情，请参阅 开始使用您的第二大脑指南。

快速入门

安装

# 基础安装
pip install chroma-mcp-server

# 完整安装，包括所有嵌入模型
pip install "chroma-mcp-server[full]"

运行

# 使用内存存储（重启时数据丢失）
chroma-mcp-server --client-type ephemeral

# 使用持久存储
chroma-mcp-server --client-type persistent --data-dir ./my_data

光标集成

在项目根目录下添加或修改 .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"
      }
    }
  }
}

最近改进

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

文档

完整的文档位于 docs 目录 中：

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

许可证

Chroma MCP 服务器根据MIT许可证（附带Commons条款）发布。这意味着您可以：

✅ 允许的：

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

❌ 不允许的：

• 出售Chroma MCP 服务器本身。
• 提供基于Chroma MCP 服务器的托管服务。
• 创建基于Chroma MCP 服务器的竞争产品。

详见 LICENSE.md 文件中的完整许可文本。