Chroma MCP 服务器

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

动机：AI 开发工作记忆

在 AI 辅助的开发工作流程中，特别是当使用 Cursor 或 GitHub Copilot 等工具进行多次会话时，维护先前交互的上下文至关重要，但通常需要手动操作。开发人员经常创建临时 markdown 文件或其他工件，仅仅是为了捕获上下文并将其重新加载到新的聊天会话中。

Chroma MCP 服务器旨在通过提供持久的、可搜索的“工作记忆”来简化此过程：

• 自动上下文回忆： 无需手动加载上下文，AI 助手（在特定规则或指令的指导下）可以查询此 MCP 服务器，以根据当前开发任务从过去的会话中检索相关信息。
• 开发人员管理持久性： 开发人员可以主动总结当前会话中的关键决策、代码片段或见解，并通过 MCP 接口将其存储在 ChromaDB 中。这允许随着时间的推移构建一个丰富的、与任务相关的知识库。
• 关注点分离： 这种“工作记忆”与最终面向用户的文档或提交的代码工件不同，而是专门用于捕获开发过程本身短暂但有价值的上下文。

通过 MCP 集成 ChromaDB，此服务器有助于实现更无缝和上下文感知的 AI 辅助开发，减少手动开销并提高跨多个会话的复杂任务的连续性。

概述

Chroma MCP 服务器允许您通过模型上下文协议将 AI 应用程序与 Chroma 连接。 这使 AI 模型能够：

• 存储和检索嵌入
• 对向量数据执行语义搜索
• 管理嵌入集合
• 支持 RAG（检索增强生成）工作流程

有关可用工具及其参数的详细列表，请参阅 API 参考。

安装

选择您喜欢的安装方法：

标准安装

# 使用 pip
pip install chroma-mcp-server

# 使用 UVX（推荐用于 Cursor）
uv pip install chroma-mcp-server

完整安装（包含嵌入模型）

# 使用 pip
pip install chroma-mcp-server[full]

# 使用 UVX
uv pip install "chroma-mcp-server[full]"

用法

启动服务器

# 使用命令行可执行文件
chroma-mcp-server

# 或使用 Python 模块
python -m chroma_mcp.server

检查版本

chroma-mcp-server --version

配置

可以使用命令行选项或环境变量配置服务器：

命令行选项

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

环境变量

export CHROMA_CLIENT_TYPE=persistent
export CHROMA_DATA_DIR=./my_data
export CHROMA_LOG_DIR=./logs
chroma-mcp-server

可用配置选项

• --client-type: Chroma 客户端的类型 (ephemeral, persistent, http, cloud)
• --data-dir: 持久客户端的数据目录路径
• --log-dir: 日志目录的路径
• --host: HTTP 客户端的主机地址
• --port: HTTP 客户端的端口
• --ssl: 是否为 HTTP 客户端使用 SSL
• --tenant: Cloud 客户端的租户 ID
• --database: Cloud 客户端的数据库名称
• --api-key: Cloud 客户端的 API 密钥
• --cpu-execution-provider: 强制嵌入函数的 CPU 执行提供程序 (auto, true, false)

有关更多设置详细信息，请参阅 入门指南。

Cursor 集成

要与 Cursor 一起使用，请将以下内容添加到您的 .cursor/mcp.json：

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

有关更多详细信息，请参阅 Cursor 集成。

开发

有关如何设置开发环境、运行测试、构建包和贡献的说明，请参阅 开发者指南。

测试工具

MCP 测试流程 文档中提供了使用 MCP 工具的模拟工作流程。

许可证

MIT 许可证（请参阅 LICENSE）