KosmoKrator

data

Chroma MCP Integration for Codex

Connect Chroma to Codex through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 5 read 2 write API key auth
Submit Chroma feedback View package source

Connect Chroma to Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

Chroma MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "mcpServers": {
    "kosmokrator-chroma": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=chroma",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=chroma --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Chroma instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Chroma Tools Visible to Codex

Codex sees stable MCP tool names generated from the Chroma integration catalog.

MCP toolSource functionTypeDescription
integration__chroma__chroma_list_collections chroma.chroma_list_collections Read List all vector collections in Chroma. Returns collection names and IDs that can be used for further operations.
integration__chroma__chroma_get_collection chroma.chroma_get_collection Read Get details of a specific Chroma collection by its name or UUID, including metadata and document count.
integration__chroma__chroma_create_collection chroma.chroma_create_collection Write Create a new vector collection in Chroma. Collections are used to store and query document embeddings.
integration__chroma__chroma_add_documents chroma.chroma_add_documents Write Add documents with embeddings to a Chroma collection. Each document requires an ID and either embeddings or text content.
integration__chroma__chroma_query_documents chroma.chroma_query_documents Read Search for similar documents in a Chroma collection using query embeddings or text. Returns the most similar documents ranked by distance.
integration__chroma__chroma_get_document chroma.chroma_get_document Read Retrieve specific documents from a Chroma collection by their IDs. Returns the full documents including text, embeddings, and metadata.
integration__chroma__chroma_get_health chroma.chroma_get_health Read Check the health status of the Chroma vector database server. Returns heartbeat and version information.

Related Chroma Pages

Chroma CLIUse direct JSON commands instead of MCP discovery. Chroma MCPFull gateway reference and MCP tool names. KosmoKrator for CodexClient-level gateway setup.