# fiftyone-mcp-server

Give an AI agent access to FiftyOne datasets, operators, and app controls. Use it to query data or work with the interface through natural language.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 26
- Author: voxel51
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/voxel51/fiftyone-mcp-server
- Updated: 2026-09-24
- HTML: https://affpapa.org/en/nevibecode/mcp/fiftyone-mcp-server

## What it does

The server lets an agent inspect FiftyOne datasets, run operators, and control the FiftyOne App. Its tools cover aggregations, sample fields and tags, schema changes, and plugin management. It includes 50 operators; installing plugins adds more capabilities.

Tools run in SDK, APP, or SESSION mode. SDK operations work without an app connection, while APP mode needs a connected browser through `ctx.ops` to control the interface. SESSION tools can start a local App server. The distinction matters: without that browser connection, real-time UI control is unavailable.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add fiftyone-mcp-server -- uvx fiftyone-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from fiftyone-mcp-server <command>

### Codex

**Platform CLI**
```bash
codex mcp add fiftyone-mcp-server -- uvx fiftyone-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from fiftyone-mcp-server <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fiftyone-mcp-server": {
            "command": "uvx",
            "args": [
                "fiftyone-mcp-server"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from fiftyone-mcp-server <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fiftyone-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "fiftyone-mcp-server"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from fiftyone-mcp-server <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add fiftyone-mcp-server uvx fiftyone-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from fiftyone-mcp-server <command>

## When to use it
- list datasets and retrieve a summary
- run a FiftyOne operator on dataset content
- change sample fields or tags
- control the FiftyOne App view

## Example prompts
- Show my available FiftyOne datasets and summarize each one.
- Find images similar to this sample in my dataset.
- Select samples in the FiftyOne App and open a panel.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md