Chroma MCP Server

This repository contains a Model Context Protocol (MCP) server implementation leveraging Chroma for vector database capabilities. It facilitates semantic document search, metadata filtering, and document management with persistent storage.

Requirements

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

Components

The server provides document storage and retrieval through Chroma, persisting data in the src/chroma/data directory. It supports semantic similarity search. Key tools include create_document, read_document, update_document, delete_document, list_documents, and search_similar. These tools enable CRUD operations and search functionality with options for metadata and content filtering.

Features

The server offers semantic search using Chroma's embeddings, metadata and content filtering, persistent storage, comprehensive error handling, and retry logic.

Installation

Instructions are provided for installing dependencies using uv venv and uv sync --dev --all-extras.

Configuration

Configuration details are provided for Claude Desktop, including specifying the command and arguments for running the server.

Usage

Instructions are provided for starting the server using uv run chroma and examples of using MCP tools to interact with the server.

Error Handling

The server provides clear error messages for common scenarios.

Development

Instructions are provided for testing and building the server.

Contributing

Guidelines are provided for contributing to the project.

License

This project is licensed under the MIT License.