Chroma Mcp Serveur

Aperçu

Qu'est-ce que Chroma ?

Chroma est un projet open-source conçu pour fournir un serveur MCP (Minecraft : Java Edition) puissant et flexible. Il permet aux joueurs de vivre Minecraft d'une manière unique, offrant diverses fonctionnalités qui améliorent le gameplay et la gestion du serveur. Le projet est hébergé sur GitHub sous l'utilisateur "privetin" et est accessible au public pour des contributions et des améliorations.

Fonctionnalités de Chroma

Paramètres de serveur personnalisables : Chroma permet aux administrateurs de serveur de personnaliser divers paramètres pour adapter l'expérience de jeu à leurs préférences.
Interface conviviale : Le projet est livré avec une interface conviviale qui simplifie la gestion et la configuration du serveur.
Support communautaire actif : Étant un projet open-source, Chroma bénéficie d'une communauté active qui contribue à son développement et fournit un support aux utilisateurs.
Mises à jour régulières : Le projet est régulièrement mis à jour pour corriger des bugs, améliorer les performances et ajouter de nouvelles fonctionnalités, garantissant une expérience de jeu fluide.
Compatibilité : Chroma est conçu pour être compatible avec diverses versions de Minecraft, le rendant polyvalent pour différentes bases de joueurs.

Comment utiliser Chroma

Installation : Pour commencer avec Chroma, téléchargez la dernière version depuis le dépôt GitHub. Suivez les instructions d'installation fournies dans la documentation.
Configuration : Après l'installation, configurez les paramètres du serveur selon vos préférences. Cela inclut la configuration des permissions des joueurs, des modes de jeu et d'autres paramètres du serveur.
Lancement du serveur : Une fois configuré, lancez le serveur et invitez les joueurs à rejoindre. Assurez-vous que votre serveur exécute la bonne version de Minecraft pour la compatibilité.
Engagement communautaire : Engagez-vous avec la communauté Chroma sur GitHub pour obtenir de l'aide, faire des demandes de fonctionnalités et des contributions. Vous pouvez signaler des problèmes, suggérer des améliorations ou même contribuer du code.

Questions Fréquemment Posées

Q : Chroma est-il gratuit à utiliser ?

R : Oui, Chroma est un projet open-source et est gratuit à utiliser pour tout le monde.

Q : Comment puis-je contribuer à Chroma ?

R : Vous pouvez contribuer en signalant des problèmes, en suggérant des fonctionnalités ou en soumettant des modifications de code via des demandes de tirage sur le dépôt GitHub.

Q : Quelles versions de Minecraft Chroma prend-il en charge ?

R : Chroma est conçu pour être compatible avec plusieurs versions de Minecraft. Vérifiez toujours la documentation pour les dernières informations de compatibilité.

Q : Où puis-je trouver de l'aide pour Chroma ?

R : Le support peut être trouvé dans la section des problèmes du dépôt GitHub, où vous pouvez poser des questions et signaler des problèmes. De plus, des forums communautaires peuvent fournir une assistance supplémentaire.

Q : Puis-je personnaliser l'expérience de jeu sur mon serveur Chroma ?

R : Absolument ! Chroma offre d'amples options de personnalisation pour adapter l'expérience de jeu à vos préférences.

Détail

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

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

Start the server:

uv run chroma

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

Run the MCP Inspector for interactive testing:

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

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

Building

Update dependencies:

uv compile pyproject.toml

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.

{ "mcpServers": { "chroma": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/metorial/mcp-container--privetin--chroma--chroma", "chroma" ], "env": {} } } }