fiftyone-mcp-server

FiftyOne MCP サーバー

FiftyOne MCP サーバーとは？

エージェントが自然言語を使ってデータセットを探索し、オペレーターを実行し、FiftyOne App を操作できるようにします。このサーバーは、データ操作、App UI の制御、オペレーター／プラグインのエコシステム全体にわたる 45 個以上の MCP ツールを提供します。

"List all my datasets"
"Load quickstart dataset and show summary"
"Find similar images in my dataset"

サーバーには、組み込みオペレーターが 50 個用意されています。プラグインをインストールすると機能を拡張できます。必要に応じて、AI がプラグイン（brain、zoo、annotation、evaluation など）を自動的に検出してインストールできます。

利用可能なツール

ツールモード

実行時モードごとに整理された 45 個以上のツール：

• SDK：どこでも利用できるデータ操作（データセット、集計、スキーマ、サンプル、オペレーター、プラグイン）。App への接続は不要です。
• APP：FiftyOne App UI をリアルタイムで制御します（set_view、open_panel、notify、select_samples、reload など、25 個以上）。ctx.ops 経由でブラウザーに接続する必要があります。
• SESSION：ローカルの App サーバーを起動するためのブートストラップツール（launch_app）です。ターミナル環境から使用します。

ツールの選択

利用できるツールは、サーバーの統合方法によって異なります。

ツールのリスクレベル

各ツールには、エージェントが自動承認の判断に使用できるリスクレベルが付けられています。

• LOW プロンプトなしで安全に自動実行できます（読み取り専用のクエリ、UI の状態変更）
• OPERATOR 実行前に重大度を確認する必要がある FiftyOne オペレーターをラップします

クイックスタート

ステップ 1：MCP サーバーをインストールする

pip install fiftyone-mcp-server

⚠️ 重要： AI ツールの設定時には、MCP サーバーをインストールしたものと同じ Python 環境を使用してください。仮想環境または conda 環境にインストールした場合は、その環境を有効にするか、実行ファイルのフルパスを指定する必要があります。

ステップ 2：AI ツールを設定する

claude mcp add fiftyone -- fiftyone-mcp

{
  "mcpServers": {
    "fiftyone": {
      "command": "fiftyone-mcp"
    }
  }
}

{
  "mcpServers": {
    "fiftyone": {
      "command": "fiftyone-mcp"
    }
  }
}

{
  "servers": {
    "fiftyone": {
      "command": "fiftyone-mcp"
    }
  }
}

{
  "mcpServers": {
    "fiftyone": {
      "command": "fiftyone-mcp"
    }
  }
}

{
  "mcpServers": {
    "fiftyone": {
      "command": "uvx",
      "args": ["fiftyone-mcp-server"]
    }
  }
}

ステップ 3：使用する

"List all my datasets"
"Load quickstart dataset and show summary"
"Open the map panel and show me the embeddings"
"Select samples with confidence above 0.9"
"What plugins are available? Install the brain plugin"
"Find near-duplicate images in my dataset"

Claude はオペレーターを自動的に検出し、適切なツールを実行します。

貢献

皆さまからの貢献を歓迎します！ローカル開発環境をセットアップする方法は次のとおりです。

1. リポジトリをクローンする

   git clone https://github.com/voxel51/fiftyone-mcp-server.git
   cd fiftyone-mcp-server
   

2. 依存関係をインストールする

   poetry install
   

3. サーバーをローカルで実行する

   poetry run fiftyone-mcp
   

4. 変更をテストする

   poetry run pytest
   poetry run black -l 79 src/
   npx @modelcontextprotocol/inspector poetry run fiftyone-mcp
   

5. プルリクエストを送信する

リソース

コミュニティ

FiftyOne コミュニティに参加して、サポートを受けたり、アイデアを共有したり、ほかのユーザーと交流したりしましょう。

• Discord： FiftyOne コミュニティ
• GitHub Issues： バグの報告や機能のリクエスト