Groundlight MCP Server

🚀 地面之光 MCP 服務器

地面之光 MCP 服務器是一個與 Groundlight 交互的模型上下文協議 (MCP) 服務器。它為用戶提供了創建和列出檢測器 (Detectors) 與圖像查詢 (ImageQueries) 的工具，助力用戶更好地處理圖像相關任務。不過需要注意的是，此 MCP 服務器目前仍處於早期開發階段，功能和服務可能會隨時發生變化和擴展，因為開發團隊正在不斷地對服務器進行開發和改進。

🚀 快速開始

本服務器提供了一系列實用工具，幫助用戶與 Groundlight 進行交互，以下是各工具的詳細介紹：

1. create_detector

• 描述：依據指定配置創建一個檢測器，支持三種模式：
  • 二進制：針對圖像自然語言查詢給出“是”或“否”的回答。
  • 多分類：按照自然語言查詢將圖像歸類到預定義類別中。
  • 計數：運用自然語言描述統計圖像中指定對象的數量。

所有檢測器都會對圖像進行分析，以回答自然語言查詢，並返回置信度分數，該分數體現了結果的可靠性。若置信度低於指定閾值，查詢將升級至人工審核。同時，檢測器會通過從反饋和額外示例中持續學習來不斷優化性能。

• 輸入：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