🧠 mcp.chroma

🧠 mcp.chroma

用于向量嵌入、集合和文档管理的 ChromaDB MCP 服务。

📋 概述

此 MCP 服务为使用 ChromaDB 提供接口。ChromaDB 是一个向量数据库，用于存储嵌入。它通过 MCP（模型-控制器-协议）接口提供的一组工具，支持对集合和文档执行操作。

✨ 功能

• 📊 集合管理（创建、列出、修改、删除）
• 📄 文档操作（添加、查询、获取、更新、删除）
• 🧠 用于会话管理的思维处理
• 🔌 多种客户端类型（HTTP、Cloud、Persistent、Ephemeral）

🚀 安装

克隆代码仓库并使用 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

运行服务

# Run with default configuration
./mcp-chroma

# Run with specific client type
./mcp-chroma --client-type http --host localhost --port 8000

# Run with persistent storage
./mcp-chroma --client-type persistent --data-dir ./chroma_data

可用的客户端类型

1. Ephemeral：内存客户端（默认）
2. Persistent：支持持久化的本地存储客户端
3. HTTP：通过 HTTP 连接的远程客户端
4. Cloud：托管云客户端

⚙️ 配置选项

选项	环境变量	描述	默认值
--client-type	CHROMA_CLIENT_TYPE	客户端类型（ephemeral、persistent、http、cloud）	ephemeral
--data-dir	CHROMA_DATA_DIR	持久化存储目录	None
--host	CHROMA_HOST	HTTP 客户端的主机	None
--port	CHROMA_PORT	HTTP 客户端的端口	None
--ssl	CHROMA_SSL	对 HTTP 客户端使用 SSL	true
--tenant	CHROMA_TENANT	Cloud 客户端的租户	None
--database	CHROMA_DATABASE	Cloud 客户端的数据库	None
--api-key	CHROMA_API_KEY	Cloud 客户端的 API 密钥	None
--dotenv-path	CHROMA_DOTENV_PATH	.env 文件路径	.chroma_env

🧰 工具

集合工具

• 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：处理进行中会话里的思维

📝 示例

创建集合

{
  "collection_name": "my_documents",
  "metadata": {
    "description": "A collection of example documents"
  }
}

查询文档

{
  "collection_name": "my_documents",
  "query_texts": ["What are the benefits of vector databases?"],
  "n_results": 3
}

🔧 与 Claude 集成

你可以通过设置如下配置，将 MCP-Chroma 与 Claude 配合使用：

{
  "mcpServers": {
    "chroma": {
      "command": "mcp-chroma",
      "args": [
        "--client-type",
        "http",
        "--host",
        "localhost",
        "--port",
        "8000"
      ],
      "env": {
        "CHROMA_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

🖥️ 与 Cursor 集成

要将 MCP-Chroma 与 Cursor 配合使用，请将以下内容添加到 .vscode/mcp.json 文件中：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "chroma_api_key",
        "description": "ChromaDB API Key",
        "password": true
      }
    ],
    "servers": {
      "chroma": {
        "command": "mcp-chroma",
        "args": [
          "--client-type",
          "http",
          "--host",
          "localhost",
          "--port",
          "8000"
        ],
        "env": {
          "CHROMA_API_KEY": "${input:chroma_api_key}"
        }
      }
    }
  }
}

📄 许可证

MIT 许可证