chromadblocal-mcp-server

vespo92/chromadblocal-mcp-server

3.2

If you are the rightful owner of chromadblocal-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

ChromaDB MCP Server provides AI assistants with persistent memory using ChromaDB vector storage, enabling the creation of a growing knowledge base with each interaction.

ChromaDB MCP Server 🧠

A Model Context Protocol (MCP) server that gives AI assistants persistent memory through ChromaDB vector storage. Build your own knowledge base that grows with every interaction!

✨ Features

  • Persistent AI Memory: Your AI assistant remembers past conversations and solutions
  • Vector Search: Find similar code patterns, configurations, and documentation instantly
  • Easy Integration: Works seamlessly with Claude Desktop and other MCP-compatible clients
  • Home AI Ready: Pre-configured collections for personal projects and automation
  • Local First: Run everything on your own hardware, no cloud dependencies

šŸš€ Quick Start

Prerequisites

Installation

  1. Clone the repository

    git clone https://github.com//vespo92/chromadblocal-mcp-server.git
    cd chromadb-mcp-server
    
  2. Install dependencies

    bun install
    
  3. Start ChromaDB

    docker run -d \
      --name chromadb-local \
      -p 8001:8000 \
      -v ~/chromadb-data:/chroma/chroma \
      -e IS_PERSISTENT=TRUE \
      chromadb/chroma:latest
    
  4. Initialize collections

    bun run setup
    
  5. Configure Claude Desktop

    Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

    {
      "mcpServers": {
        "chromadb-context": {
          "command": "bun",
          "args": ["run", "/path/to/chromadb-mcp-server/index.js"],
          "env": {
            "CHROMADB_URL": "http://localhost:8001"
          }
        }
      }
    }
    
  6. Restart Claude Desktop and start building your knowledge base!

šŸ’¬ Usage Examples

Once configured, interact naturally with your AI:

Store Knowledge

  • "Store this Docker configuration in ChromaDB for future reference"
  • "Save this React component pattern with tags: hooks, authentication"
  • "Remember this solution for GPU passthrough issues"

Retrieve Information

  • "Search ChromaDB for Python async examples"
  • "Find similar component patterns to this one"
  • "What solutions do we have for Docker networking issues?"

Build Context

  • "Add this API documentation to the project_docs collection"
  • "Store these test patterns for our testing suite"

šŸ“š Available Collections

CollectionDescriptionUse Case
home_automationSmart home configs & automationsHome Assistant, IoT scripts
code_snippetsReusable code patternsFunctions, hooks, utilities
configurationsSystem & app configsDocker, Kubernetes, services
troubleshootingProblem solutionsFixes, workarounds, debugging
project_docsProject documentationAPIs, architecture, guides
learning_notesLearning insightsTutorials, concepts, notes

šŸ› ļø MCP Tools

search_context

Search for relevant information across collections

Parameters:
- query: Search query
- collection: (optional) Specific collection to search
- limit: (optional) Number of results

store_context

Store new information with metadata

Parameters:
- content: The content to store
- metadata: Tags, categories, descriptions
- collection: Target collection

list_collections

List all available collections and their metadata

find_similar_patterns

Find code patterns similar to provided example

šŸ”§ Configuration

Environment Variables

CHROMADB_URL=http://localhost:8001  # ChromaDB server URL

Custom Collections

Add new collections in setup-home-collections.js:

await createCollection('ml_experiments', {
  description: 'Machine learning experiments and results'
});

šŸ“¦ Project Structure

chromadb-mcp-server/
ā”œā”€ā”€ index.js                    # MCP server implementation
ā”œā”€ā”€ setup-home-collections.js   # Collection initialization
ā”œā”€ā”€ test-chromadb.js           # Connection test script
ā”œā”€ā”€ test-mcp.js                # MCP functionality test
ā”œā”€ā”€ HOME-AI-SETUP.md           # Detailed setup guide
ā”œā”€ā”€ package.json               # Project dependencies
└── README.md                  # This file

šŸ¤ Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

See for more details.

šŸ“„ License

This project is licensed under the MIT License - see the file for details.

šŸ™ Acknowledgments

  • Anthropic for the MCP specification
  • Chroma for the excellent vector database
  • The open-source community for inspiration and support

šŸš€ What's Next?

  • Cloud sync capabilities
  • Multi-user support
  • Web UI for collection management
  • Export/import collections
  • Integration with more AI assistants

Built with ā¤ļø for the Home AI Community