Chroma

🚀 Chroma MCP サーバー

Chroma を使用して実装された Model Context Protocol (MCP) サーバーで、ベクトルデータベース機能を提供します。このサーバーは、意味的なドキュメント検索、メタデータフィルタリング、およびドキュメント管理をサポートし、永続的なストレージもサポートしています。

🚀 クイックスタート

Chroma MCP サーバーを使い始めるには、以下の手順に従ってください。

インストール

1. 依存関係をインストールします。

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

サーバーの起動

python -m mcp_server.main --host 0.0.0.0 --port 5000

✨ 主な機能

• 意味的検索：Chroma の埋め込みを使用して、意味に基づいてドキュメントを検索します。
• メタデータフィルタリング：メタデータフィールドに基づいて検索結果をフィルタリングします。
• コンテンツフィルタリング：ドキュメントの内容に基づく追加のフィルタリングを行います。
• 永続的ストレージ：ローカルディレクトリ間でサーバーを再起動する際にデータを保持します。
• エラー処理：包括的なエラー処理と明確なメッセージを提供します。
• リトライロジック：一時的な障害に対して自動的にリトライします。

📦 インストール

1. 依存関係をインストールします。

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

📚 ドキュメント

要件

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

コンポーネント

リソース

このサーバーは、Chroma のベクトルデータベースを通じてドキュメントの保存と検索機能を提供します。

• コンテンツとメタデータを含むドキュメントを保存します。
• src/chroma/data ディレクトリにデータを永続的に保存します。
• 意味的な類似性検索をサポートします。

ツール

このサーバーは、CRUD 操作と検索機能を実装しています。

ドキュメント管理

• create_document: 新しいドキュメントを作成します。
  • 必須: document_id、content
  • オプション: metadata（キーバリューペア）
  • 戻り値: 成功確認
  • エラー: 既に存在する、無効な入力
• read_document: ID を指定してドキュメントを検索します。
  • 必須: document_id
  • 戻り値: ドキュメントの内容とメタデータ
  • エラー: 見つからない
• update_document: 既存のドキュメントを更新します。
  • 必須: document_id、content
  • オプション: metadata
  • 戻り値: 成功確認
  • エラー: 見つからない、無効な入力
• delete_document: ドキュメントを削除します。
  • 必須: document_id
  • 戻り値: 成功確認
  • エラー: 見つからない
• list_documents: すべてのドキュメントをリストします。
  • オプション: limit、offset
  • 戻り値: コンテンツとメタデータを含むドキュメントのリスト

検索操作

• search_similar: 意味的に類似したドキュメントを検索します。
  • 必須: query
  • オプション: num_results、metadata_filter、content_filter
  • 戻り値: 距離スコア付きの類似ドキュメントのランク付きリスト
  • エラー: 無効なフィルター

設定

Claude Desktop

サーバーの設定を Claude Desktop の設定に追加します。

Windows: C:\Users\<username>\AppData\Local\Claude Labs\Claude 2\config.json

ファイルの末尾に以下の内容を追加します。

{
  "mcp-server": {
    "enabled": true,
    "host": "0.0.0.0",
    "port": 5000
  }
}

Windows システムサービス設定

1. 新しいファイル mcp-service.json を作成し、以下の内容を記述します。

{
  "name": "MCP Server",
  "description": "Chroma MCP Server",
  "start_command": "uvicorn mcp_server.main:app --host 0.0.0.0 --port 5000",
  "working_directory": "%USERPROFILE%",
  "autostart": true,
  "display": false
}

2. ファイルを C:\ProgramData\uvx ディレクトリに保存します。

🔧 エラー処理

• 一般的なエラー：ポートが使用中でないか、設定が正しいかを確認してください。

🔧 開発とテスト

1. リポジトリをクローンします。

git clone https://github.com/your-repository.git
cd mcp_server
pip install -r requirements.txt

2. 開発用にサーバーを起動します。

uvicorn mcp_server.main:app --reload

🔧 貢献ガイド

1. リポジトリを Fork します。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. Pull Request を作成します。

📄 ライセンス

このプロジェクトは、LICENSE ファイルのライセンスに従っています。