ScreenLab MCP Server

A Model Context Protocol (MCP) server that provides access to the ScreenLab API for creating and managing screen scans.

Installation

Install the package globally:

npm install -g @screenlab/mcp

Authentication

Obtaining an API Token

To obtain an API token, make a POST request to the ScreenLab authentication endpoint:

curl -X POST https://api.screenlab.io/auth \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"your-password"}'

The response will contain your API token.

Setting the Token

Set your ScreenLab API token as an environment variable:

export SCREENLAB_TOKEN=your-api-token-here

Configuration

Claude Desktop

Add the following configuration to your Claude Desktop claude_desktop_config.json file:

{
  "mcpServers": {
    "screenlab": {
      "command": "screenlab-mcp",
      "env": {
        "SCREENLAB_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude Code

To use this MCP server with Claude Code, add it as a project-scoped server:

claude mcp add screenlab screenlab-mcp -s project

Make sure your SCREENLAB_TOKEN environment variable is set in your shell:

export SCREENLAB_TOKEN=your-api-token-here

To remove the server if needed:

claude mcp remove screenlab -s local

Available Tools

The server provides four tools for interacting with the ScreenLab API:

screenlab.create_scan_url

Creates a new scan from a URL.

Parameters:

• name (string): Name for the scan
• url (string): URL to scan
• type (string): Must be "overlay"
• location (string): Location/region for the scan
• width (number): Width for the scan
• height (number): Height for the scan
• explanation (boolean, optional): Whether to include explanation

screenlab.create_scan_image

Creates a new scan from image data.

Parameters:

• name (string): Name for the scan
• imageData (string): Base64 encoded image data
• type (string): Must be "overlay"
• explanation (boolean, optional): Whether to include explanation

screenlab.get_scans

Retrieves all scans from your ScreenLab account.

Parameters: None

screenlab.get_scan

Retrieves a specific scan by ID.

Parameters:

• id (string): The scan ID

Development

Building the Project

npm run build

Running in Development Mode

npm run dev

Starting the Server

npm start

License

MIT