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 构建