mcp-label-studio: A Label Studio MCP server

mcp-label-studio：Label Studio MCP 服务

概述

一个用于管理和交互 Label Studio 项目的模型上下文协议服务。此服务提供用于创建和管理标注项目、导入和导出数据以及促进数据标注工作流的工具。

工具

1. get_projects

   • 获取所有项目的信息
   • 返回：包含所有项目基本信息的列表

2. get_project_detail

   • 获取特定项目的详细信息
   • 输入：
     • project_id（string）：Label Studio 项目 ID
   • 返回：项目详细信息，包括标签配置

3. create_project

   • 创建新的标注项目
   • 输入：
     • title（string）：项目标题
     • description（string，可选）：项目描述
     • label_config（string，可选）：XML 标签配置
   • 返回：新建的项目信息

4. update_project

   • 更新现有项目
   • 输入：
     • project_id（string）：项目 ID
     • title（string，可选）：新项目标题
     • description（string，可选）：新项目描述
     • label_config（string，可选）：新的 XML 标签配置
   • 返回：更新后的项目信息

5. delete_project

   • 删除项目
   • 输入：
     • project_id（string）：要删除的项目 ID
   • 返回：删除状态

6. export_project_annotations

   • 导出项目标注数据
   • 输入：
     • project_id（string）：项目 ID
     • export_format（string，可选）：导出格式（"JSON"、"CSV"、"TSV"、"CONLL2003"、"COCO"）
     • output_path（string，可选）：导出文件的保存路径
   • 返回：导出的标注数据

7. import_tasks_from_file

   • 从文件导入任务
   • 输入：
     • project_id（string）：项目 ID
     • file_path（string）：导入文件的路径
   • 返回：导入状态

8. get_export_formats

   • 获取项目支持的导出格式
   • 输入：
     • project_id（string）：项目 ID
   • 返回：支持的导出格式列表

安装

使用 uv（推荐）

使用 uv 时，可以直接运行服务：

git clone https://github.com/yourusername/mcp-label-studio.git
cd mcp-label-studio
uv pip install -e .
uv run server.py

使用 Docker

也可以使用 Docker 运行服务：

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

配置

与 Claude Desktop 搭配使用

将以下内容添加到 claude_desktop_config.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"
    }
  }
}

"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"]
  }
}

调试

可以使用 MCP inspector 调试服务：

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

许可证

此 MCP 服务采用 MIT 许可证。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件