ChromaDB Remote MCP Server — Claude Code MCP server
A remote MCP server connects AI clients to ChromaDB over Streamable HTTP for semantic search and vector database operations.
claude mcp add --transport http chromadb-remote-mcp https://meloncafe.github.io/chromadb-remote-mcp/mcpWhat ChromaDB Remote MCP Server does
ChromaDB Remote MCP Server exposes a self-hosted ChromaDB instance to Claude Code and other MCP-compatible clients. It receives MCP requests, maps them to ChromaDB operations, and keeps vector embeddings available for semantic search. The same database can serve clients on different devices.
The server combines the MCP protocol with an authentication gateway and a REST API proxy. Python and JavaScript clients can reach ChromaDB through /api/v2/*; /docs and /openapi.json expose the API documentation. Clients connect through the /mcp endpoint, while Claude Code uses the claude mcp add command.
A manual Docker setup requires an .env file with MCP_AUTH_TOKEN, PORT, and CHROMA_DATA_PATH, followed by Docker Compose. Local development uses yarn install, yarn build, and yarn start. The server uses Streamable HTTP; its README marks SSE transport as deprecated.
What it helps with
- connect Claude Code to a remote ChromaDB instance
- search stored content with vector semantics
- share one database across AI clients
- expose ChromaDB to Python and JavaScript through REST
Example prompts for the agent
- Connect this MCP server and search ChromaDB for information related to the current task.
- Store the project context in ChromaDB so we can retrieve it in a later request.
- Check the remote ChromaDB connection and run a semantic search over the stored data.
How to install ChromaDB Remote MCP Server
Platform CLI: remote server
claude mcp add --transport http chromadb-remote-mcp https://meloncafe.github.io/chromadb-remote-mcp/mcpPlatform CLI: remote server
codex mcp add chromadb-remote-mcp-server --url https://meloncafe.github.io/chromadb-remote-mcp/mcpConfig file
{
"mcpServers": {
"chromadb-remote-mcp-server": {
"url": "https://meloncafe.github.io/chromadb-remote-mcp/mcp"
}
}
}Config file
{
"servers": {
"chromadb-remote-mcp-server": {
"type": "http",
"url": "https://meloncafe.github.io/chromadb-remote-mcp/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http chromadb-remote-mcp-server https://meloncafe.github.io/chromadb-remote-mcp/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ChromaDB Remote MCP Server
How do I install ChromaDB Remote MCP Server in Claude Code?
Run claude mcp add --transport http chromadb-remote-mcp https://meloncafe.github.io/chromadb-remote-mcp/mcp.
What does ChromaDB Remote MCP Server do?
It connects AI clients to a remote ChromaDB instance over Streamable HTTP. Its MCP tools support vector database operations and semantic search.
Which clients can connect to the server?
It can be connected to Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.
