Skip to main content

Chroma MCP server with Ollama embedding configuration

Project description

chromadb-mcp-ollama

Model Context Protocol server that mirrors the standard chroma MCP tools and adds first-class support for configuring Ollama embeddings (URL, model, timeout) so collections can be created with the Ollama embedding function.

Running

uv run chromadb-mcp-ollama \
  --client-type persistent \
  --data-dir /path/to/chroma/data \
  --dotenv-path /path/to/.env \
  --ollama-url http://localhost:11434 \
  --ollama-model nomic-embed-text \
  --ollama-timeout 90

Key flags (all also respect environment variables):

  • --client-type (CHROMA_CLIENT_TYPE): http, cloud, persistent, or ephemeral.
  • --data-dir (CHROMA_DATA_DIR): path for persistent client data.
  • --host/--port (CHROMA_HOST/CHROMA_PORT): Chroma server when using HTTP.
  • --tenant/--database/--api-key: cloud auth parameters.
  • --dotenv-path (CHROMA_DOTENV_PATH): optional env file to load before parsing flags.
  • --ollama-url (OLLAMA_URL): base URL for Ollama when embedding_function_name="ollama".
  • --ollama-model (OLLAMA_MODEL or OLLAMA_EMBED_MODEL): Ollama embedding model name.
  • --ollama-timeout (OLLAMA_TIMEOUT): Ollama request timeout in seconds.
  • --default-embedding-function-name (CHROMA_DEFAULT_EMBEDDING_FUNCTION_NAME): embedding function to use when opening existing collections (set this to match the embedding used when the collection was created; e.g. ollama).

MCP tools exposed

  • chroma_list_collections
  • chroma_create_collection
  • chroma_peek_collection
  • chroma_get_collection_info
  • chroma_get_collection_count
  • chroma_modify_collection
  • chroma_fork_collection
  • chroma_delete_collection
  • chroma_add_documents
  • chroma_query_documents
  • chroma_get_documents
  • chroma_update_documents
  • chroma_delete_documents

The tool signatures match the stock chroma MCP server. When calling chroma_create_collection, set embedding_function_name="ollama" to use the Ollama embedding function with the configured URL/model.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chromadb_mcp_ollama-0.1.1.tar.gz (6.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chromadb_mcp_ollama-0.1.1-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

File details

Details for the file chromadb_mcp_ollama-0.1.1.tar.gz.

File metadata

  • Download URL: chromadb_mcp_ollama-0.1.1.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.22

File hashes

Hashes for chromadb_mcp_ollama-0.1.1.tar.gz
Algorithm Hash digest
SHA256 63ca675e3f58f56ffeb38e0d21d5cff652f273a6c645bb53a9c3b4582e229f12
MD5 202d264ddad001ef5a86ac2035b788d9
BLAKE2b-256 20857dd74142d16e2275dad976402f1716df37f333d603427a937a3260c88a58

See more details on using hashes here.

File details

Details for the file chromadb_mcp_ollama-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for chromadb_mcp_ollama-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 eea7e21c56f6413885ace6384befbaf92f80664afbf8f3c57d94aeaf5448bea3
MD5 b374d5a7e374072b793da9ef141dad0e
BLAKE2b-256 757429987ca6a65dd17fa58fce63671dbb3794d9bfa4eac5750ce64d4a780a71

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page