Chroma MCP Server

简介

Chroma MCP 服务器实现了模型上下文协议，提供语义文档搜索、元数据过滤和持久化文档管理功能。

安装

uv venv
uv sync --dev --all-extras

配置 Claude Desktop

将以下配置添加到 Claude Desktop 配置文件中：

• Windows: C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json
• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "chroma": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/MCP/server/community/chroma",
        "run",
        "chroma"
      ]
    }
  }
}

启动服务器

uv run chroma

核心功能

文档管理

• 创建、读取、更新和删除文档
• 文档包含内容和可选元数据
• 数据持久化存储在 src/chroma/data 目录

搜索功能

• 语义相似度搜索
• 元数据和内容过滤筛选

使用示例

创建文档

create_document({
    "document_id": "ml_paper1",
    "content": "卷积神经网络提高了图像识别准确性。",
    "metadata": {
        "year": 2020,
        "field": "计算机视觉",
        "complexity": "高级"
    }
})

搜索相似文档

search_similar({
    "query": "机器学习模型",
    "num_results": 2,
    "metadata_filter": {
        "year": 2020,
        "field": "计算机视觉"
    }
})

测试

使用 MCP Inspector 进行交互式测试：

npx @modelcontextprotocol/inspector uv --directory C:/MCP/server/community/chroma run chroma

系统要求

• Python 3.8+
• Chroma 0.4.0+
• MCP SDK 0.1.0+

许可证

MIT 许可证