groundlight-mcp-server

概述

用于与 Groundlight 交互的模型上下文协议 (MCP) 服务器。此服务器提供创建和列出检测器 (Detector) 和图像查询 (ImageQuery) 的工具。

此 MCP 服务器仍处于早期开发阶段。随着我们不断开发和改进服务器，其功能和可用工具可能会发生变化和扩展。

工具

Groundlight MCP 服务器中提供以下工具：

1. create_detector

   • 描述：根据指定的配置创建检测器。支持三种模式：

     1. 二元 (Binary)：对关于图像的自然语言查询回答“是”或“否”。
     2. 多类别 (Multiclass)：根据自然语言查询将图像分类为预定义的类别。
     3. 计数 (Counting)：使用自然语言描述计算图像中指定对象的出现次数。

     所有检测器都分析图像以回答自然语言查询，并返回置信度分数，指示结果的可靠性。如果置信度低于指定的阈值，则查询将升级到人工审核。检测器通过持续从反馈和附加示例中学习来不断改进。

   • 输入：config（DetectorConfig 对象，包含 name、query、confidence_threshold、mode 和特定于模式的配置）

   • 返回：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 Desktop 一起使用

将此添加到您的 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