Groundlight MCP Server

🚀 地面之光 MCP サーバ

このサーバは、Groundlight とやり取りするモデルコンテキストプロトコル (MCP) サーバです。このサーバを使うと、検出器 (Detectors) と画像クエリ (ImageQueries) の作成と一覧表示ができます。

この MCP サーバはまだ開発の初期段階にあり、機能やサービスは変更や拡張される可能性があります。私たちはサーバの開発と改善を続けています。

🚀 クイックスタート

このサーバを使うことで、Groundlight とのやり取りを通じて、画像の検出やクエリの管理が可能になります。以下に、サポートされているツールや設定方法、開発に関する情報を紹介します。

✨ 主な機能

ツール

Groundlight MCP サーバで利用できるツールは以下の通りです。

1. create_detector

   • 説明：指定された設定に基づいて検出器を作成します。3 つのモードをサポートしています。

     1. バイナリ：画像に対する自然言語クエリに対して「はい」または「いいえ」で回答します。
     2. マルチクラス分類：自然言語クエリに基づいて、画像を事前定義されたカテゴリに分類します。
     3. カウント：自然言語で指定されたオブジェクトの画像内の数をカウントします。

     すべての検出器は、自然言語クエリに回答するために画像を分析し、結果の信頼性を示す信頼度スコアを返します。信頼度が指定された閾値を下回る場合、クエリは人工審査に回されます。検出器はフィードバックや追加の例から学習し、継続的に改善されます。

   • 入力：config（name、query、confidence_threshold、mode およびモード固有の設定を含む DetectorConfig オブジェクト）

   • 戻り値：Detector オブジェクト

2. get_detector

   • 説明：ID を指定して検出器を取得します。
   • 入力：detector_id（文字列）
   • 戻り値：Detector オブジェクト

3. list_detectors

   • 説明：現在のユーザーに関連付けられているすべての検出器を一覧表示します。
   • 入力：なし
   • 戻り値：Detector オブジェクトのリスト

4. submit_image_query

   • 説明：指定された検出器を使用して、画像を提出して回答を取得します。画像はファイルパス、URL、または生のバイトとして提供できます。検出器はラベルと信頼度スコアを含む応答を返します。
   • 入力：detector_id（文字列）、image（文字列またはバイト）
   • 戻り値：ImageQuery オブジェクト

5. get_image_query

   • 説明：ID を指定して既存の画像クエリを取得します。
   • 入力：image_query_id（文字列）
   • 戻り値：ImageQuery オブジェクト

6. list_image_queries

   • 説明：指定された検出器に関連付けられているすべての画像クエリを一覧表示します。大量の結果が返される可能性があります。
   • 入力：detector_id（文字列）
   • 戻り値：ImageQuery オブジェクトのリスト

7. get_image

   • 説明：画像クエリ ID を指定して画像を取得します。画像にバウンディングボックスを付けて注釈を付けることもできます。
   • 入力：image_query_id（文字列）、annotate（ブール値、デフォルトは false）
   • 戻り値：Image オブジェクト

📦 インストール

設定

Claude デスクトップとの連携

以下の内容を claude_desktop_config.json に追加します。

Docker

"mcpServers": {
  "groundlight": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "-e", "GROUNDLIGHT_API_TOKEN", "groundlight/groundlight-mcp-server"],
    "env": {
        "GROUNDLIGHT_API_TOKEN": "YOUR_API_TOKEN_HERE"
    }
  }
}

🔧 開発

ローカルでの Docker イメージのビルド

make build-docker

ローカルでの Docker イメージの実行

make run-docker

[Groundlight 内部] Docker イメージを Docker Hub にプッシュする（DockerHub の資格情報が必要）

make push-docker