项目简介

Groundlight MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它充当 LLM 客户端与 Groundlight 图像分析平台之间的桥梁。通过此服务器，LLM 可以调用 Groundlight 提供的图像分析工具，例如创建图像检测器、提交图像查询并获取分析结果。这使得 LLM 能够利用 Groundlight 的图像识别能力来增强其上下文理解和决策能力。

主要功能点

图像检测器管理：
- 创建新的图像检测器，用于分析图像并回答自然语言提问（例如，判断图像中是否存在特定物体）。
- 获取指定 ID 的检测器信息。
- 列出当前用户关联的所有检测器。
图像查询处理：
- 提交图像以供指定的检测器分析，图像可以来自本地文件、URL 或直接提供字节数据。
- 获取指定 ID 的图像查询结果。
- 获取图像查询关联的原始图像数据。
- 列出指定检测器的所有图像查询记录。

安装步骤

安装 Docker：确保您的系统已安装 Docker。
获取 Groundlight API Token：您需要拥有一个 Groundlight 账户并获取 API Token，用于服务器访问 Groundlight 服务。
配置 MCP 客户端：在您的 MCP 客户端（例如 Claude Desktop）中配置 Groundlight MCP Server。

服务器配置

以下是在 MCP 客户端 (如 Claude Desktop) 中配置 Groundlight MCP Server 的 JSON 格式示例。您需要将此配置添加到客户端的配置文件中。

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

配置参数说明：

'server name': '"groundlight"' (服务器名称，可以自定义，用于在客户端中标识该服务器).
'command': '"docker"' (运行服务器的命令，这里使用 Docker).
'args': '["run", "--rm", "-i", "-e", "GROUNDLIGHT_API_TOKEN", "groundlight/groundlight-mcp-server"]' (传递给 'docker run' 命令的参数列表).
- 'run': Docker 运行命令。
- '--rm': 容器退出后自动删除容器。
- '-i': 保持标准输入 (STDIN) 打开。
- '-e GROUNDLIGHT_API_TOKEN': 设置名为 'GROUNDLIGHT_API_TOKEN' 的环境变量，用于传递 Groundlight API 令牌。
- 'groundlight/groundlight-mcp-server': 要运行的 Docker 镜像名称。
'env':
- 'GROUNDLIGHT_API_TOKEN': '"YOUR_API_TOKEN_HERE"' (环境变量配置，用于设置 Groundlight API 令牌). 请将 '"YOUR_API_TOKEN_HERE"' 替换为您实际的 Groundlight API Token。

基本使用方法

启动 MCP 服务器：配置完成后，MCP 服务器将会在客户端启动时自动通过 Docker 运行。
在 LLM 中调用工具：在您的 LLM 应用中，您可以使用预定义的工具名称（如 'create_binary_detector', 'submit_image_query' 等）来调用 Groundlight MCP Server 提供的功能。工具的具体名称、描述和参数请参考仓库的 'README.md' 文件中 "Tools" 部分的说明。
与 Groundlight 交互：通过 LLM 客户端与 MCP 服务器的交互，您可以利用 Groundlight 强大的图像分析能力，例如创建检测特定物体的检测器，并上传图像进行分析，从而获取图像分析结果并集成到您的 LLM 应用中。

注意事项

首次使用可能需要拉取 Docker 镜像，请确保网络连接。
'GROUNDLIGHT_API_TOKEN' 必须正确配置，否则服务器将无法连接 Groundlight 服务。

关键词