Chroma Mcp Server

Cos'è Chroma?

Chroma è un progetto open-source progettato per fornire un potente e flessibile server MCP (Minecraft: Java Edition). Permette ai giocatori di vivere Minecraft in un modo unico, offrendo varie funzionalità che migliorano il gameplay e la gestione del server. Il progetto è ospitato su GitHub sotto l'utente "privetin" ed è accessibile pubblicamente per contributi e miglioramenti.

Caratteristiche di Chroma

• Impostazioni del Server Personalizzabili: Chroma consente agli amministratori del server di personalizzare varie impostazioni per adattare l'esperienza di gioco ai propri gusti.
• Interfaccia Utente Intuitiva: Il progetto viene fornito con un'interfaccia utente intuitiva che semplifica la gestione e la configurazione del server.
• Supporto della Comunità Attivo: Essendo un progetto open-source, Chroma beneficia di una comunità attiva che contribuisce al suo sviluppo e fornisce supporto agli utenti.
• Aggiornamenti Regolari: Il progetto viene aggiornato regolarmente per correggere bug, migliorare le prestazioni e aggiungere nuove funzionalità, garantendo un'esperienza di gioco fluida.
• Compatibilità: Chroma è progettato per essere compatibile con varie versioni di Minecraft, rendendolo versatile per diverse basi di giocatori.

Come Utilizzare Chroma

1. Installazione: Per iniziare con Chroma, scarica l'ultima versione dal repository GitHub. Segui le istruzioni di installazione fornite nella documentazione.
2. Configurazione: Dopo l'installazione, configura le impostazioni del server secondo le tue preferenze. Questo include la configurazione dei permessi dei giocatori, delle modalità di gioco e di altri parametri del server.
3. Avvio del Server: Una volta configurato, avvia il server e invita i giocatori a unirsi. Assicurati che il tuo server stia eseguendo la versione corretta di Minecraft per la compatibilità.
4. Coinvolgimento della Comunità: Interagisci con la comunità di Chroma su GitHub per supporto, richieste di funzionalità e contributi. Puoi segnalare problemi, suggerire miglioramenti o persino contribuire con codice.

Domande Frequenti

D: Chroma è gratuito da usare?

R: Sì, Chroma è un progetto open-source ed è gratuito per tutti.

D: Come posso contribuire a Chroma?

R: Puoi contribuire segnalando problemi, suggerendo funzionalità o inviando modifiche al codice tramite pull request sul repository GitHub.

D: Quali versioni di Minecraft supporta Chroma?

R: Chroma è progettato per essere compatibile con più versioni di Minecraft. Controlla sempre la documentazione per le ultime informazioni sulla compatibilità.

D: Dove posso trovare supporto per Chroma?

R: Il supporto può essere trovato nella sezione problemi del repository GitHub, dove puoi fare domande e segnalare problemi. Inoltre, i forum della comunità possono fornire ulteriore assistenza.

D: Posso personalizzare l'esperienza di gioco sul mio server Chroma?

R: Assolutamente! Chroma offre ampie opzioni di personalizzazione per adattare l'esperienza di gioco ai tuoi gusti.

Chroma MCP Server

A Model Context Protocol (MCP) server implementation that provides vector database capabilities through Chroma. This server enables semantic document search, metadata filtering, and document management with persistent storage.

Requirements

• Python 3.8+
• Chroma 0.4.0+
• MCP SDK 0.1.0+

Components

Resources

The server provides document storage and retrieval through Chroma's vector database:

• Stores documents with content and metadata
• Persists data in src/chroma/data directory
• Supports semantic similarity search

Tools

The server implements CRUD operations and search functionality:

Document Management

• create_document: Create a new document

  • Required: document_id, content
  • Optional: metadata (key-value pairs)
  • Returns: Success confirmation
  • Error: Already exists, Invalid input

• read_document: Retrieve a document by ID

  • Required: document_id
  • Returns: Document content and metadata
  • Error: Not found

• update_document: Update an existing document

  • Required: document_id, content
  • Optional: metadata
  • Returns: Success confirmation
  • Error: Not found, Invalid input

• delete_document: Remove a document

  • Required: document_id
  • Returns: Success confirmation
  • Error: Not found

• list_documents: List all documents

  • Optional: limit, offset
  • Returns: List of documents with content and metadata

Search Operations

• search_similar: Find semantically similar documents
  • Required: query
  • Optional: num_results, metadata_filter, content_filter
  • Returns: Ranked list of similar documents with distance scores
  • Error: Invalid filter

Features

• Semantic Search: Find documents based on meaning using Chroma's embeddings
• Metadata Filtering: Filter search results by metadata fields
• Content Filtering: Additional filtering based on document content
• Persistent Storage: Data persists in local directory between server restarts
• Error Handling: Comprehensive error handling with clear messages
• Retry Logic: Automatic retries for transient failures

Installation

1. Install dependencies:

uv venv
uv sync --dev --all-extras

Configuration

Claude Desktop

Add the server configuration to your Claude Desktop config:

Windows: C:\Users\<username>\AppData\Roaming\Claude\claude_desktop_config.json

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "chroma": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/MCP/server/community/chroma",
        "run",
        "chroma"
      ]
    }
  }
}

Data Storage

The server stores data in:

• Windows: src/chroma/data
• MacOS/Linux: src/chroma/data

Usage

1. Start the server:

uv run chroma

2. Use MCP tools to interact with the server:

### Create a document
create_document({
    "document_id": "ml_paper1",
    "content": "Convolutional neural networks improve image recognition accuracy.",
    "metadata": {
        "year": 2020,
        "field": "computer vision",
        "complexity": "advanced"
    }
})

### Search similar documents
search_similar({
    "query": "machine learning models",
    "num_results": 2,
    "metadata_filter": {
        "year": 2020,
        "field": "computer vision"
    }
})

Error Handling

The server provides clear error messages for common scenarios:

• Document already exists [id=X]
• Document not found [id=X]
• Invalid input: Missing document_id or content
• Invalid filter
• Operation failed: [details]

Development

Testing

1. Run the MCP Inspector for interactive testing:

npx @modelcontextprotocol/inspector uv --directory C:/MCP/server/community/chroma run chroma

2. Use the inspector's web interface to:
   • Test CRUD operations
   • Verify search functionality
   • Check error handling
   • Monitor server logs

Building

1. Update dependencies:

uv compile pyproject.toml

2. Build package:

uv build

Contributing

Contributions are welcome! Please read our Contributing Guidelines for details on:

• Code style
• Testing requirements
• Pull request process

License

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