🚀 地面之光 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