Chroma

mcp

A Model Context Protocol (MCP) server implementation that provides database capabilities for Chroma.

5.0K

13 Tools

Packaged by

Requires Secrets

Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

Overview Tools (13)Config Manual installation

Docker Hub⁠Github repository⁠

Use cases

Add documents to a Chroma collection.

Create a new Chroma collection with configurable HNSW parameters.

Delete a Chroma collection.

Delete documents from a Chroma collection.

Fork a Chroma collection.

Get the number of documents in a Chroma collection.

Get information about a Chroma collection.

Get documents from a Chroma collection with optional filtering.

List all collection names in the Chroma database with pagination support.

Modify a Chroma collection's name or metadata.

View all

About

Chroma MCP Server

A Model Context Protocol (MCP) server implementation that provides database capabilities for Chroma.

What is an MCP Server?⁠

Characteristics

Attribute	Details
Docker Image	mcp/chroma⁠
Author	chroma-core⁠
Repository	https://github.com/chroma-core/chroma-mcp⁠
Dockerfile	https://github.com/chroma-core/chroma-mcp/blob/main/Dockerfile⁠
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/chroma --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
Licence	Apache License 2.0

Available Tools (13)

Tools provided by this Server	Short Description
`chroma_add_documents`	Add documents to a Chroma collection.
`chroma_create_collection`	Create a new Chroma collection with configurable HNSW parameters.
`chroma_delete_collection`	Delete a Chroma collection.
`chroma_delete_documents`	Delete documents from a Chroma collection.
`chroma_fork_collection`	Fork a Chroma collection.
`chroma_get_collection_count`	Get the number of documents in a Chroma collection.
`chroma_get_collection_info`	Get information about a Chroma collection.
`chroma_get_documents`	Get documents from a Chroma collection with optional filtering.
`chroma_list_collections`	List all collection names in the Chroma database with pagination support.
`chroma_modify_collection`	Modify a Chroma collection's name or metadata.
`chroma_peek_collection`	Peek at documents in a Chroma collection.
`chroma_query_documents`	Query documents from a Chroma collection with advanced filtering.
`chroma_update_documents`	Update documents in a Chroma collection.

Tools Details

Tool: `chroma_add_documents`

Add documents to a Chroma collection.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to add documents to
`documents`	`array`	List of text documents to add
`ids`	`array`	List of IDs for the documents (required)
`metadatas`	`string`optional	Optional list of metadata dictionaries for each document

Tool: `chroma_create_collection`

Create a new Chroma collection with configurable HNSW parameters.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to create
`embedding_function_name`	`string`optional	Name of the embedding function to use. Options: 'default', 'cohere', 'openai', 'jina', 'voyageai', 'ollama', 'roboflow'
`metadata`	`string`optional	Optional metadata dict to add to the collection

Tool: `chroma_delete_collection`

Delete a Chroma collection.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to delete

Tool: `chroma_delete_documents`

Delete documents from a Chroma collection.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to delete documents from
`ids`	`array`	List of document IDs to delete

Tool: `chroma_fork_collection`

Fork a Chroma collection.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to fork
`new_collection_name`	`string`	Name of the new collection to create

Tool: `chroma_get_collection_count`

Get the number of documents in a Chroma collection.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to count

Tool: `chroma_get_collection_info`

Get information about a Chroma collection.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to get info about

Tool: `chroma_get_documents`

Get documents from a Chroma collection with optional filtering.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to get documents from
`ids`	`string`optional	Optional list of document IDs to retrieve
`include`	`array`optional	List of what to include in response. By default, this will include documents, and metadatas.
`limit`	`string`optional	Optional maximum number of documents to return
`offset`	`string`optional	Optional number of documents to skip before returning results
`where`	`string`optional	Optional metadata filters using Chroma's query operators
`where_document`	`string`optional	Optional document content filters

Tool: `chroma_list_collections`

List all collection names in the Chroma database with pagination support.

Parameters	Type	Description
`limit`	`string`optional	Optional maximum number of collections to return
`offset`	`string`optional	Optional number of collections to skip before returning results

Tool: `chroma_modify_collection`

Modify a Chroma collection's name or metadata.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to modify
`new_metadata`	`string`optional	Optional new metadata for the collection
`new_name`	`string`optional	Optional new name for the collection

Tool: `chroma_peek_collection`

Peek at documents in a Chroma collection.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to peek into
`limit`	`integer`optional	Number of documents to peek at

Tool: `chroma_query_documents`

Query documents from a Chroma collection with advanced filtering.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to query
`query_texts`	`array`	List of query texts to search for
`include`	`array`optional	List of what to include in response. By default, this will include documents, metadatas, and distances.
`n_results`	`integer`optional	Number of results to return per query
`where`	`string`optional	Optional metadata filters using Chroma's query operators
`where_document`	`string`optional	Optional document content filters

Tool: `chroma_update_documents`

Update documents in a Chroma collection.

Parameters	Type	Description
`collection_name`	`string`	Name of the collection to update documents in
`ids`	`array`	List of document IDs to update (required)
`documents`	`string`optional	Optional list of new text documents.
`embeddings`	`string`optional	Optional list of new embeddings for the documents.
`metadatas`	`string`optional	Optional list of new metadata dictionaries for the documents.

Use this MCP Server

{
  "mcpServers": {
    "chroma": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CHROMA_API_KEY",
        "mcp/chroma"
      ],
      "env": {
        "CHROMA_API_KEY": "your-api-key"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠

Manual installation

You can install the MCP server using:

Installation for

Chroma

Chroma MCP Server

Characteristics

Available Tools (13)

Tools Details

Tool: `chroma_add_documents`

Tool: `chroma_create_collection`

Tool: `chroma_delete_collection`

Tool: `chroma_delete_documents`

Tool: `chroma_fork_collection`

Tool: `chroma_get_collection_count`

Tool: `chroma_get_collection_info`

Tool: `chroma_get_documents`

Tool: `chroma_list_collections`

Tool: `chroma_modify_collection`

Tool: `chroma_peek_collection`

Tool: `chroma_query_documents`

Tool: `chroma_update_documents`

Use this MCP Server

Related servers

AWS Core MCP Server

Context7

Desktop Commander

Docker Hub

Chroma

Chroma MCP Server

Characteristics

Available Tools (13)

Tools Details

Tool: chroma_add_documents

Tool: chroma_create_collection

Tool: chroma_delete_collection

Tool: chroma_delete_documents

Tool: chroma_fork_collection

Tool: chroma_get_collection_count

Tool: chroma_get_collection_info

Tool: chroma_get_documents

Tool: chroma_list_collections

Tool: chroma_modify_collection

Tool: chroma_peek_collection

Tool: chroma_query_documents

Tool: chroma_update_documents

Use this MCP Server

Related servers

AWS Core MCP Server

Context7

Desktop Commander

Docker Hub

Tool: `chroma_add_documents`

Tool: `chroma_create_collection`

Tool: `chroma_delete_collection`

Tool: `chroma_delete_documents`

Tool: `chroma_fork_collection`

Tool: `chroma_get_collection_count`

Tool: `chroma_get_collection_info`

Tool: `chroma_get_documents`

Tool: `chroma_list_collections`

Tool: `chroma_modify_collection`

Tool: `chroma_peek_collection`

Tool: `chroma_query_documents`

Tool: `chroma_update_documents`