# djm81
## 基本信息
- Slug: `djm81-chroma_mcp_server`
- Source: modelscope
- Publisher: @djm81/chroma_mcp_server
- Categories: knowledge-and-memory / vector-databases / rag-systems
- Hosted: No
- License: Other
- Source URL: https://www.modelscope.cn/mcp/servers/@djm81/chroma_mcp_server
## 简介
暂无描述。
## MCP Server 详情

# Chroma MCP 服务器

[![CI](https://github.com/djm81/chroma_mcp_server/actions/workflows/tests.yml/badge.svg)](https://github.com/djm81/chroma_mcp_server/actions/workflows/tests.yml)
[![codecov](https://codecov.io/gh/djm81/chroma_mcp_server/branch/main/graph/badge.svg)](https://codecov.io/gh/djm81/chroma_mcp_server)
[![PyPI - Version](https://img.shields.io/pypi/v/chroma-mcp-server?color=blue)](https://pypi.org/project/chroma-mcp-server)

这是一个用于 [Chroma](https://www.trychroma.com/) 的模型上下文协议 (MCP) 服务器集成，Chroma 是一个开源嵌入数据库。

## 概述

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

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

主要特性：

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

更多详情请参阅 [开始使用您的第二大脑指南](docs/getting_started_second_brain.md)。

## 快速入门

### 安装

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 目录](docs/) 中找到。- [主文档](docs/README.md) - 安装、配置和使用完整指南
- [入门指南](docs/getting_started.md) - 详细的设置说明
- [开发者指南](docs/developer_guide.md) - 面向贡献者和开发者的指南
- [服务器日志记录](docs/logging/server_logging.md) - 改进的日志系统详情
- [增强的上下文捕获](docs/usage/enhanced_context_capture.md) - 代码差异提取和工具序列化的细节
- [语义代码分块](docs/usage/semantic_chunking.md) - 保持逻辑完整的代码分块，以便有意义地检索
- [自动化聊天日志记录](docs/integration/automated_chat_logging.md) - 带有双向链接的丰富聊天历史记录
- [自动化测试工作流](docs/usage/automated_test_workflow.md) - 基于自动验证的测试驱动学习
- [API 参考](docs/api_reference.md) - 可用的 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](LICENSE.md) 文件以获取完整的许可证文本。