groundlight-mcp-server

groundlight-mcp-server

site icon
2025.04.12 1
Python图像分析自然语言处理内容生成
groundlight-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务,主要用于与 Groundlight 平台进行交互。该服务提供了创建和管理检测器(Detectors)以及图像查询(ImageQueries)的工具。检测器支持多种模式,包括二进制分类、多类分类和对象计数,能够根据自然语言查询分析图像并返回结果。服务还支持图像查询的提交、获取和列表功能,适用于需要图像分析和自然语言处理的应用场景。
View on GitHub

Overview

基本能力

产品定位

groundlight-mcp-server 是一个用于图像分析和自然语言处理的 MCP 服务,主要用于创建和管理检测器以及图像查询。

核心功能

  1. 创建检测器(create_detector):支持二进制分类、多类分类和对象计数模式,根据自然语言查询分析图像并返回结果。
  2. 获取检测器(get_detector):通过检测器 ID 获取检测器信息。
  3. 列出检测器(list_detectors):列出当前用户的所有检测器。
  4. 提交图像查询(submit_image_query):提交图像到指定检测器进行分析,返回标签和置信度分数。
  5. 获取图像查询(get_image_query):通过图像查询 ID 获取查询结果。
  6. 列出图像查询(list_image_queries):列出指定检测器的所有图像查询。
  7. 获取图像(get_image):获取图像查询关联的图像,可选标注边界框。

适用场景

  1. 图像分类:根据自然语言查询对图像进行分类。
  2. 对象计数:统计图像中特定对象的数量。
  3. 自动化审核:通过检测器自动审核图像内容。
  4. 数据标注:获取图像查询结果并标注图像。

工具列表

  1. create_detector:创建检测器,支持多种模式。
  2. get_detector:获取检测器信息。
  3. list_detectors:列出所有检测器。
  4. submit_image_query:提交图像查询。
  5. get_image_query:获取图像查询结果。
  6. list_image_queries:列出所有图像查询。
  7. get_image:获取图像并可选标注。

常见问题解答

  1. 如何获取 API Token:需要在配置文件中设置 GROUNDLIGHT_API_TOKEN
  2. 如何运行服务:可以通过 Docker 运行服务。
  3. 如何构建 Docker 镜像:使用 make build-docker 命令构建。

使用教程

使用依赖

  1. 安装 Docker:确保系统已安装 Docker。

安装教程

  1. 构建 Docker 镜像: bash make build-docker
  2. 运行 Docker 镜像: bash make run-docker
  3. 配置 Claude Desktop: 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" } } }

调试方式

  1. 检查 Docker 容器是否运行: bash docker ps
  2. 查看服务日志: bash docker logs <container_id>

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。