groundlight-mcp-server by

Overview

A Model Context Protocol (MCP) server for interacting with Groundlight. This server provides tools to create, list and customize Detectors, submit and list ImageQueries, create, list and delete Alerts, and examine detector evaluation metrics.

The functionality and available tools are subject to change and expansion as we continue to develop and improve this server.

Tools

The following tools are available in the Groundlight MCP server:

1. create_detector

1. Binary: Answers 'yes' or 'no' to a natural-language query about images.

2. Multiclass: Classifies images into predefined categories based on natural-language queries.

3. Counting: Counts occurrences of specified objects in images using natural-language descriptions.

All detectors analyze images to answer natural-language queries and return confidence scores indicating result reliability. If confidence falls below the specified threshold, the query is escalated to human review. Detectors improve over time through continuous learning from feedback and additional examples.

2. get_detector

3. list_detectors

4. submit_image_query

5. get_image_query

6. list_image_queries

7. get_image

8. create_alert

9. list_alerts

10. delete_alert

11. add_label

12. get_detector_evaluation_metrics

13. update_detector_confidence_threshold

14. update_detector_escalation_type

Configuration

Usage with Claude Desktop

Add this to your claude_desktop_config.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"
    }
  }
}

Usage with Zed

Add this to your settings.json:

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

Development

Build the Docker image locally:

make build-docker

Run the Docker image locally:

make run-docker

[Groundlight Internal] Push the Docker image to Docker Hub (requires DockerHub credentials):

make push-docker

s