mcp-label-studio: A Label Studio MCP server

by lxkaka

261 downloads

Not rated

GitHub

Other

About

mcp-label-studio is a Model Context Protocol (MCP) server that connects to Label Studio to manage and interact with annotation projects. It provides tools to create, update, delete projects, import tasks from files, and export annotations in multiple formats, enabling automated…

Details

Author: lxkaka
Downloads: 261
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name mcp-label-studio: A Label Studio MCP server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

From the repository

Install via uv (recommended) by cloning the repository and running uv pip install -e . and uv run server.py, or use Docker with docker build and docker run setting the LABEL_STUDIO_API_KEY and LABEL_STUDIO_URL environment variables. Integrate with Claude Desktop by adding the server configuration (uv or docker variant) to claude_desktop_config.json.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-label-studio: a label studio mcp server": {
            "mcp-label-studio": {
                "command": "uv",
                "args": [
                    "pip",
                    "install",
                    "-e",
                    "."
                ]
            }
        }
    }
}

McpServers

{
    "mcp-label-studio": {
        "command": "uv",
        "args": [
            "pip",
            "install",
            "-e",
            "."
        ]
    }
}

# mcp-label-studio: A Label Studio MCP server ## Overview A Model Context Protocol server for managing and interacting with Label Studio projects. This server provides tools to create and manage annotation projects, import and export data, and facilitate the data labeling workflow. ### Tools 1. `get_projects` - Get all projects information - Returns: A list of all projects with their basic information 2. `get_project_detail` - Get detailed information about a specific project - Input: - `project_id` (string): Label Studio project ID - Returns: Detailed project information including label configuration 3. `create_project` - Create a new annotation project - Input: - `title` (string): Project title - `description` (string, optional): Project description - `label_config` (string, optional): XML label configuration - Returns: New project information 4. `update_project` - Update an existing project - Input: - `project_id` (string): Project ID - `title` (string, optional): New project title - `description` (string, optional): New project description - `label_config` (string, optional): New XML label configuration - Returns: Updated project information 5. `delete_project` - Delete a project - Input: - `project_id` (string): Project ID to delete - Returns: Deletion status 6. `export_project_annotations` - Export project annotation data - Input: - `project_id` (string): Project ID - `export_format` (string, optional): Format to export ("JSON", "CSV", "TSV", "CONLL2003", "COCO") - `output_path` (string, optional): Path to save the export file - Returns: Exported annotation data 7. `import_tasks_from_file` - Import tasks from a file - Input: - `project_id` (string): Project ID - `file_path` (string): Path to the import file - Returns: Import status 8. `get_export_formats` - Get supported export formats for a project - Input: - `project_id` (string): Project ID - Returns: List of supported export formats ## Installation ### Using uv (recommended) When using [`uv`](https://docs.astral.sh/uv/), you can run the server directly: ```bash git clone https://github.com/yourusername/mcp-label-studio.git cd mcp-label-studio uv pip install -e . uv run server.py ``` ### Using Docker You can also use Docker to run the server: ```bash docker build -t mcp-label-studio . docker run -e LABEL_STUDIO_API_KEY=your-api-key -e LABEL_STUDIO_URL=http://your-label-studio-instance mcp-label-studio ``` ## Configuration ### Usage with Claude Desktop Add this to your `claude_desktop_config.json`: <details> <summary>Using uv</summary> ```json "mcpServers": { "label-studio": { "command": "uv", "args": ["run", "/path/to/mcp-label-studio/server.py"], "env": { "LABEL_STUDIO_API_KEY": "YOUR_LABEL_STUDIO_API_KEY", "LABEL_STUDIO_URL": "YOUR_LABEL_STUDIO_URL" } } } ``` </details> <details> <summary>Using docker</summary> ```json "mcpServers": { "label-studio": { "command": "docker", "args": ["run", "-i", "--rm", "-e", "LABEL_STUDIO_API_KEY=YOUR_API_KEY", "-e", "LABEL_STUDIO_URL=YOUR_URL", "mcp-label-studio"] } } ``` </details> ## Debugging You can use the MCP inspector to debug the server: ```bash cd /path/to/mcp-label-studio LABEL_STUDIO_API_KEY=YOUR_API_KEY LABEL_STUDIO_URL=YOUR_URL npx @modelcontextprotocol/inspector uv run server.py ``` ## License This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repositoy

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

Sequential Thinking