Chroma MCP Server

Chroma MCP Server

site icon
2025.04.12 93
Python嵌入数据库LLM应用支持数据检索数据库
Chroma MCP Server 是一个开源的嵌入数据库,专为LLM(大型语言模型)应用设计,提供高效的数据检索能力。它支持创建、管理和查询文档集合,具备向量搜索、全文搜索和元数据过滤等功能。适用于需要为AI模型提供上下文数据的场景,如知识库构建、上下文记忆增强等。
View on GitHub

Overview

基本能力

产品定位

Chroma MCP Server 是一个开源的嵌入数据库,旨在为LLM应用提供高效的数据检索能力。

核心功能

  • 灵活的客户端类型:支持内存型(测试开发)、持久型(文件存储)、HTTP客户端(自托管实例)和云客户端(Chroma Cloud集成)。
  • 集合管理:创建、修改、删除集合,支持分页列表和集合统计。
  • 文档操作:添加、查询、更新和删除文档,支持语义搜索和高级过滤。
  • 嵌入函数:支持多种嵌入函数(如Cohere、OpenAI等),并支持环境变量配置API密钥。

适用场景

  • 构建LLM应用的上下文记忆系统。
  • 创建和管理知识库。
  • 实现高效的文档检索和过滤。

工具列表

  • chroma_list_collections:列出所有集合。
  • chroma_create_collection:创建新集合。
  • chroma_peek_collection:查看集合中的文档样本。
  • chroma_get_collection_info:获取集合详细信息。
  • chroma_get_collection_count:获取集合中的文档数量。
  • chroma_modify_collection:更新集合名称或元数据。
  • chroma_delete_collection:删除集合。
  • chroma_add_documents:添加文档。
  • chroma_query_documents:查询文档。
  • chroma_get_documents:按ID或过滤器检索文档。
  • chroma_update_documents:更新文档。
  • chroma_delete_documents:删除文档。

常见问题解答

  • 嵌入函数支持:需确保使用Chroma v1.0.0及以上版本以支持嵌入函数持久化。
  • API密钥配置:通过环境变量或.env文件配置API密钥,确保安全。

使用教程

使用依赖

无特定前置依赖,但需确保已安装Python或JavaScript环境以运行LLM应用。

安装教程

  1. 通过uvx命令安装chroma-mcp
uvx chroma-mcp
  1. 配置claude_desktop_config.json文件以添加客户端类型(内存型、持久型、云客户端或HTTP客户端)。

调试方式

  1. 使用环境变量配置客户端参数:
export CHROMA_CLIENT_TYPE="http"
export CHROMA_HOST="your-host"
export CHROMA_PORT="your-port"
  1. 启动服务后,使用工具命令(如chroma_list_collections)验证功能。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。