Fiftyone MCP Server

🚀 FiftyOne MCP Server

Model Context Protocolを使用してAIアシスタント経由でFiftyOneデータセットを制御できるサーバーです。

🚀 クイックスタート

オプション1: pip (最も簡単)

pip install fiftyone-mcp-server

次に、AIツールの設定に追加して再起動します。

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

オプション2: uvx (インストール不要)

uvがインストールされている場合:

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

これにより、最新バージョンが自動的にダウンロードされて実行されます。

✨ 主な機能

• データセット管理 (3つのツール) - データセットの一覧表示、読み込み、要約
• オペレーターシステム (5つのツール) - 任意のFiftyOneオペレーターを動的に実行
• プラグイン管理 (5つのツール) - FiftyOneプラグインの検索とインストール
• セッション管理 (3つのツール) - 委任実行用にFiftyOneアプリを制御
• 自然言語ワークフロー - 会話を通じた多段階操作
• ChatGPTとClaude互換 - デスクトップアプリで動作

💻 使用例

設定後、AIアシスタントを再起動して以下を試してみましょう。

"List all my datasets"
"Load quickstart dataset and show summary"
"What operators are available for managing samples?"
"Set context to my dataset, then tag high-confidence samples"
"What plugins are available? Install the brain plugin"
"Find similar images in my dataset"

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

📚 ドキュメント

概要

ChatGPTやClaudeが自然言語を通じてデータセットを探索し、オペレーターを実行し、コンピュータビジョンワークフローを構築できるようにします。このサーバーは、16のMCPツールを通じてFiftyOneのオペレーターフレームワーク（80以上の組み込みオペレーター）を公開します。

アーキテクチャ

設計哲学: 最小限のツール数（16ツール）、最大限の柔軟性（完全なオペレーターとプラグインエコシステム）

🔧 開発への参加

貢献を歓迎します！以下はローカル開発環境のセットアップ方法です。

ローカル開発環境のセットアップ

# リポジトリをクローン
git clone https://github.com/AdonaiVera/fiftyone-mcp-server.git
cd fiftyone-mcp-server

# Poetryをインストール（未インストールの場合）
curl -sSL https://install.python-poetry.org | python3 -

# 依存関係をインストール
poetry install

# サーバーをローカルで実行
poetry run fiftyone-mcp

変更のテスト

# テストを実行
poetry run pytest

# コードフォーマット
poetry run black -l 79 src/

# リンティング
poetry run pylint --errors-only src/

# MCP Inspectorでテスト
npx @modelcontextprotocol/inspector poetry run fiftyone-mcp

ローカルバージョンをClaudeで使用する

Claude Desktopでローカルの変更をテストするには、設定を更新します。

{
  "mcpServers": {
    "fiftyone": {
      "command": "poetry",
      "args": ["run", "fiftyone-mcp"],
      "cwd": "/absolute/path/to/fiftyone-mcp-server"
    }
  }
}

📌 参考リソース

• FiftyOne Docs
• FiftyOne Operators
• Model Context Protocol
• MCP Inspector
• PyPI Package

Built with FiftyOne and Model Context Protocol