Chroma Mcp サーバー

概要

Chromaとは？

Chromaは、強力で柔軟なMCP（Minecraft: Java Edition）サーバーを提供するために設計されたオープンソースプロジェクトです。プレイヤーはMinecraftをユニークな方法で体験でき、ゲームプレイやサーバー管理を向上させるさまざまな機能を提供します。このプロジェクトは、ユーザー「privetin」の下でGitHubにホストされており、貢献や改善のために公開されています。

Chromaの特徴

カスタマイズ可能なサーバー設定：Chromaはサーバー管理者がさまざまな設定をカスタマイズできるようにし、好みに合わせたゲームプレイ体験を提供します。
ユーザーフレンドリーなインターフェース：プロジェクトには、サーバー管理と設定を簡素化するユーザーフレンドリーなインターフェースが付属しています。
活発なコミュニティサポート：オープンソースプロジェクトであるため、Chromaは開発に貢献し、ユーザーにサポートを提供する活発なコミュニティの恩恵を受けています。
定期的なアップデート：プロジェクトは定期的にアップデートされ、バグ修正、パフォーマンス向上、新機能の追加が行われ、スムーズなゲーム体験を保証します。
互換性：ChromaはさまざまなMinecraftバージョンと互換性があるように設計されており、異なるプレイヤーベースに対して多用途です。

Chromaの使い方

インストール：Chromaを始めるには、GitHubリポジトリから最新のリリースをダウンロードします。ドキュメントに記載されたインストール手順に従ってください。
設定：インストール後、好みに応じてサーバー設定を構成します。これには、プレイヤーの権限、ゲームモード、その他のサーバーパラメータの設定が含まれます。
サーバーの起動：設定が完了したら、サーバーを起動し、プレイヤーを招待します。互換性のために、サーバーが正しいバージョンのMinecraftを実行していることを確認してください。
コミュニティとの関わり：GitHubでChromaコミュニティと関わり、サポート、機能リクエスト、貢献を行います。問題を報告したり、改善を提案したり、コードを貢献したりできます。

よくある質問

Q: Chromaは無料で使用できますか？

A: はい、Chromaはオープンソースプロジェクトであり、誰でも無料で使用できます。

Q: Chromaにどのように貢献できますか？

A: 問題を報告したり、機能を提案したり、GitHubリポジトリでプルリクエストを通じてコードの変更を提出することで貢献できます。

Q: ChromaはどのバージョンのMinecraftをサポートしていますか？

A: Chromaは複数のMinecraftバージョンと互換性があるように設計されています。最新の互換性情報については、常にドキュメントを確認してください。

Q: Chromaのサポートはどこで見つけられますか？

A: サポートはGitHubリポジトリの問題セクションで見つけることができ、質問をしたり問題を報告したりできます。また、コミュニティフォーラムがさらなる支援を提供する場合もあります。

Q: Chromaサーバーでゲームプレイ体験をカスタマイズできますか？

A: もちろんです！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

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

概要