mcp-label-studio: A Label Studio MCP server

mcp-label-studio：Label Studio MCP サーバー

概要

Label Studio プロジェクトを管理し、操作するための Model Context Protocol サーバーです。このサーバーには、アノテーションプロジェクトの作成と管理、データのインポートとエクスポート、データラベリングのワークフローを支援するツールが用意されています。

ツール

1. get_projects

   • すべてのプロジェクト情報を取得します
   • 戻り値：基本情報を含むすべてのプロジェクトの一覧

2. get_project_detail

   • 特定のプロジェクトの詳細情報を取得します
   • 入力：
     • project_id (string)：Label Studio のプロジェクト ID
   • 戻り値：ラベル設定を含むプロジェクトの詳細情報

3. create_project

   • 新しいアノテーションプロジェクトを作成します
   • 入力：
     • title (string)：プロジェクトのタイトル
     • description (string, optional)：プロジェクトの説明
     • label_config (string, optional)：XML ラベル設定
   • 戻り値：新しいプロジェクトの情報

4. update_project

   • 既存のプロジェクトを更新します
   • 入力：
     • project_id (string)：プロジェクト ID
     • title (string, optional)：新しいプロジェクトのタイトル
     • description (string, optional)：新しいプロジェクトの説明
     • label_config (string, optional)：新しい XML ラベル設定
   • 戻り値：更新されたプロジェクトの情報

5. delete_project

   • プロジェクトを削除します
   • 入力：
     • project_id (string)：削除するプロジェクト ID
   • 戻り値：削除ステータス

6. export_project_annotations

   • プロジェクトのアノテーションデータをエクスポートします
   • 入力：
     • project_id (string)：プロジェクト ID
     • export_format (string, optional)：エクスポート形式（"JSON"、"CSV"、"TSV"、"CONLL2003"、"COCO"）
     • output_path (string, optional)：エクスポートファイルの保存先パス
   • 戻り値：エクスポートされたアノテーションデータ

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 License のライセンスで提供されています。MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。