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