Chroma Mcp Сервер

Созданоprivetinprivetin

MCP сервер для Chroma

Обзор

Что такое Chroma?

Chroma — это проект с открытым исходным кодом, созданный для предоставления мощного и гибкого сервера MCP (Minecraft: Java Edition). Он позволяет игрокам испытать Minecraft уникальным образом, предлагая различные функции, которые улучшают игровой процесс и управление сервером. Проект размещен на GitHub под пользователем "privetin" и доступен для общественных вкладов и улучшений.

Особенности Chroma

  • Настраиваемые параметры сервера: Chroma позволяет администраторам сервера настраивать различные параметры, чтобы адаптировать игровой процесс под свои предпочтения.
  • Удобный интерфейс: Проект поставляется с удобным интерфейсом, который упрощает управление сервером и его настройку.
  • Активная поддержка сообщества: Будучи проектом с открытым исходным кодом, Chroma получает выгоду от активного сообщества, которое вносит вклад в его развитие и предоставляет поддержку пользователям.
  • Регулярные обновления: Проект регулярно обновляется для исправления ошибок, улучшения производительности и добавления новых функций, что обеспечивает плавный игровой процесс.
  • Совместимость: Chroma разработан для совместимости с различными версиями Minecraft, что делает его универсальным для разных групп игроков.

Как использовать Chroma

  1. Установка: Чтобы начать работу с Chroma, загрузите последнюю версию из репозитория GitHub. Следуйте инструкциям по установке, приведенным в документации.
  2. Настройка: После установки настройте параметры сервера в соответствии с вашими предпочтениями. Это включает в себя настройку прав игроков, игровых режимов и других параметров сервера.
  3. Запуск сервера: После настройки запустите сервер и пригласите игроков присоединиться. Убедитесь, что ваш сервер работает на правильной версии Minecraft для совместимости.
  4. Взаимодействие с сообществом: Взаимодействуйте с сообществом Chroma на GitHub для получения поддержки, запросов на функции и вкладов. Вы можете сообщать о проблемах, предлагать улучшения или даже вносить изменения в код.

Часто задаваемые вопросы

В: Chroma бесплатен для использования?

О: Да, Chroma — это проект с открытым исходным кодом и бесплатен для использования всеми.

В: Как я могу внести вклад в Chroma?

О: Вы можете внести вклад, сообщая о проблемах, предлагая функции или отправляя изменения в код через запросы на слияние в репозитории GitHub.

В: Какие версии Minecraft поддерживает Chroma?

О: Chroma разработан для совместимости с несколькими версиями Minecraft. Всегда проверяйте документацию для получения актуальной информации о совместимости.

В: Где я могу найти поддержку для Chroma?

О: Поддержку можно найти в разделе проблем репозитория GitHub, где вы можете задавать вопросы и сообщать о проблемах. Кроме того, форумы сообщества могут предоставить дополнительную помощь.

В: Могу ли я настроить игровой процесс на своем сервере Chroma?

О: Абсолютно! Chroma предлагает обширные возможности настройки, чтобы адаптировать игровой процесс под ваши предпочтения.

Деталь

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
  1. 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
  1. 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
  1. 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": {}
    }
  }
}

Информация о проекте

Автор
privetin
Category
Другое
Создано
Aug 11, 2025
Звезда
36
Язык
Python
Теги
-

Chroma Mcp Сервер Альтернатива

В качестве альтернативы Chroma Mcp Сервер которую вы можете рассмотреть, мы предлагаем сайты, разделённые по категориям.

Посмотреть ещё >>