Fiftyone MCP Server

🚀 FiftyOne MCP Server

FiftyOne MCP Server 允許通過 AI 助手，使用自然語言控制 FiftyOne 數據集，執行操作符並構建計算機視覺工作流，為數據處理和分析帶來便利。

🚀 快速開始

選項 1：使用 pip 安裝（最簡單的方式）

pip install fiftyone-mcp-server

安裝完成後，將其添加到你的 AI 工具配置中並重啟：

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

claude mcp add fiftyone -- fiftyone-mcp

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

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

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

選項 2：使用 uvx（無需安裝）

如果你已經安裝了 uv，可以使用以下配置：

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

此配置會自動下載並運行最新版本。

✨ 主要特性

• 數據集管理（3 個工具）：可列出、加載數據集。
• 操作符執行（5 個工具）：能動態執行任何 FiftyOne 操作符。
• 插件管理（5 個工具）：可發現並安裝 FiftyOne 插件。
• 會話管理（3 個工具）：控制 FiftyOne App 進行委託執行。
• 自然語言工作流：支持通過對話進行多步操作。
• 兼容 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 等）。

📚 詳細文檔

架構

設計理念：工具數量最少（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 文檔
• FiftyOne 操作符
• Model Context Protocol
• MCP Inspector
• PyPI 包

基於 FiftyOne 和 Model Context Protocol 構建