Chroma MCP 服务器

这是一个用于 Chroma 的模型上下文协议 (MCP) 服务器集成，Chroma 是一个开源嵌入数据库。

概述

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

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

主要特性：

• 自动代码库索引： 跟踪并索引代码变更
• 自动聊天日志记录： 记录 AI 交互，并增强上下文捕获（代码差异、工具序列）
• 双向链接： 将讨论与代码变更连接起来，以便追踪功能演变
• 语义代码分块： 保留逻辑代码结构，以便更有效地检索上下文
• 工作记忆工具： 用于捕获和检索开发上下文的 MCP 命令
• 验证系统： 基于证据的验证，用于代码变更和学习提升
• 自动化测试驱动学习： 从测试失败到验证修复和学习提升的完全自动化工作流程

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

快速入门

安装

bash

基本安装

pip install chroma-mcp-server

完整安装所有嵌入模型

pip install "chroma-mcp-server[full]"

运行

bash

使用内存存储（重启后数据丢失）

chroma-mcp-server --client-type ephemeral

使用持久化存储

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

Cursor 集成

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

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"
}
}
}
}

最近的改进

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

文档

详细的文档可以在 docs 目录 中找到。- 主文档 - 安装、配置和使用完整指南

• 入门指南 - 详细的设置说明
• 开发者指南 - 面向贡献者和开发者的指南
• 服务器日志记录 - 改进的日志系统详情
• 增强的上下文捕获 - 代码差异提取和工具序列化的细节
• 语义代码分块 - 保持逻辑完整的代码分块，以便有意义地检索
• 自动化聊天日志记录 - 带有双向链接的丰富聊天历史记录
• 自动化测试工作流 - 基于自动验证的测试驱动学习
• API 参考 - 可用的 MCP 工具和参数

许可证

Chroma MCP Server 根据 MIT License with Commons Clause 授权。这意味着您可以：

✅ 允许：

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

❌ 不允许：

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

请参阅 LICENSE.md 文件以获取完整的许可证文本。