🧠 mcp.chroma

🧠 mcp.chroma

site icon
2025.04.13 1
Rust向量数据库文档管理数据库
mcp.chroma 是一个基于 ChromaDB 的 MCP 服务器,专注于向量嵌入、集合和文档管理。它通过 MCP(Model-Controller-Protocol)接口提供了一系列工具,用于操作集合和文档。
View on GitHub

Overview

基本能力

产品定位

mcp.chroma 是一个用于向量嵌入、集合和文档管理的 MCP 服务器,基于 ChromaDB 构建。

核心功能

  • 集合管理:创建、列出、修改、删除集合
  • 文档操作:添加、查询、获取、更新、删除文档
  • 会话管理:处理会话中的思考过程
  • 多客户端支持:支持 HTTP、云、持久化和临时客户端

适用场景

  • 需要管理大量向量嵌入数据的应用
  • 需要高效查询和检索文档的系统
  • 需要会话管理和思考处理的 AI 应用

工具列表

集合工具

  • 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:从集合中检索文档
  • chroma_update_documents:更新现有文档
  • chroma_delete_documents:从集合中删除文档

思考处理

  • process_thought:处理会话中的思考

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

需要安装 Rust 和 Cargo。

安装教程

git clone https://github.com/yourusername/mcp-chroma.git
cd mcp-chroma
cargo build --release

调试方式

设置环境

创建 .chroma_env 文件:

CHROMA_CLIENT_TYPE=ephemeral
CHROMA_HOST=localhost
CHROMA_PORT=8000

运行服务器

# 使用默认配置运行
./mcp-chroma

# 使用特定客户端类型运行
./mcp-chroma --client-type http --host localhost --port 8000

# 使用持久化存储运行
./mcp-chroma --client-type persistent --data-dir ./chroma_data

可用客户端类型

  1. 临时:内存客户端(默认)
  2. 持久化:带有持久化的本地存储客户端
  3. HTTP:通过 HTTP 的远程客户端
  4. :托管的云客户端

许可证

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