PyPI - fiftyone-mcp-server - Versions diffs - 0.1.0__tar.gz → 0.1.2__tar.gz - Mend

fiftyone-mcp-server 0.1.0tar.gz → 0.1.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

{fiftyone_mcp_server-0.1.0 → fiftyone_mcp_server-0.1.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fiftyone-mcp-server
-Version: 0.1.0
+Version: 0.1.2
 Summary: MCP server exposing FiftyOne dataset analysis tools
 License: MIT
 Keywords: mcp,fiftyone,computer-vision,ai,datasets,model-context-protocol
@@ -17,8 +17,8 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.9
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: Scientific/Engineering :: Image Recognition
 Requires-Dist: fiftyone (>=1.0,<2.0)
 Requires-Dist: mcp (>=0.9.0,<0.10.0)
 Requires-Dist: torch (>=2.9.1,<3.0.0)
@@ -31,6 +31,8 @@ Description-Content-Type: text/markdown
 # FiftyOne MCP Server
+<!-- mcp-name: io.github.AdonaiVera/fiftyone-mcp-server -->
 <div align="center">
 <p align="center">
@@ -42,6 +44,9 @@ Description-Content-Type: text/markdown
 > Control FiftyOne datasets through AI assistants using the Model Context Protocol
+[![PyPI](https://img.shields.io/pypi/v/fiftyone-mcp-server.svg)](https://pypi.org/project/fiftyone-mcp-server/)
+[![Python](https://img.shields.io/pypi/pyversions/fiftyone-mcp-server.svg)](https://pypi.org/project/fiftyone-mcp-server/)
 </p>
 </div>
@@ -53,59 +58,116 @@ Enable ChatGPT and Claude to explore datasets, execute operators, and build comp
 - **Dataset Management (3 tools)** - List, load, and summarize datasets
 - **Operator System (5 tools)** - Execute any FiftyOne operator dynamically
-  - Context management (dataset/view/selection)
-  - Operator discovery and schema resolution
-  - Dynamic execution interface
 - **Plugin Management (5 tools)** - Discover and install FiftyOne plugins
-  - List available plugins and their operators
-  - Install plugins from GitHub on demand
-  - Enable/disable plugins dynamically
 - **Session Management (3 tools)** - Control FiftyOne App for delegated execution
-  - Launch/close FiftyOne App server
-  - Required for background operators (brain, evaluation, etc.)
-  - Session info and status monitoring
 - **Natural Language Workflows** - Multi-step operations through conversation
 - **ChatGPT & Claude Compatible** - Works with desktop apps
-## Installation
+## Quick Start
+### Option 1: pip (Simplest)
 ```bash
-git clone https://github.com/AdonaiVera/fiftyone-mcp-server.git
-cd fiftyone-mcp-server
-poetry install
+pip install fiftyone-mcp-server
 ```
-**Requirements:** Python 3.10-3.13, Poetry, FiftyOne
+Then add to your AI tool config and restart:
-## Configuration
+<details>
+<summary><b>Claude Desktop</b></summary>
-Add to MCP config:
-- ChatGPT: `~/Library/Application Support/ChatGPT/config.json`
-- Claude: `~/Library/Application Support/Claude/claude_desktop_config.json`
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
 ```json
 {
   "mcpServers": {
     "fiftyone": {
-      "command": "poetry",
-      "args": ["run", "fiftyone-mcp"],
-      "cwd": "/absolute/path/to/fiftyone-mcp-server"
+      "command": "fiftyone-mcp"
     }
   }
 }
 ```
-Restart your AI assistant.
+</details>
-## Usage
+<details>
+<summary><b>Claude Code</b></summary>
+```bash
+claude mcp add fiftyone -- fiftyone-mcp
 ```
-# Run
-poetry run fiftyone-mcp
+</details>
+<details>
+<summary><b>Cursor</b></summary>
+Add to Cursor MCP settings:
+```json
+{
+  "fiftyone": {
+    "command": "fiftyone-mcp"
+  }
+}
+```
+</details>
+<details>
+<summary><b>VSCode</b></summary>
+Add to `.vscode/mcp.json`:
+```json
+{
+  "servers": {
+    "fiftyone": {
+      "command": "fiftyone-mcp"
+    }
+  }
+}
+```
+</details>
+<details>
+<summary><b>ChatGPT Desktop</b></summary>
+Edit `~/Library/Application Support/ChatGPT/config.json`:
+```json
+{
+  "mcpServers": {
+    "fiftyone": {
+      "command": "fiftyone-mcp"
+    }
+  }
+}
 ```
-And then you can query directly the agent:
+</details>
+### Option 2: uvx (No Install Needed)
+If you have [uv](https://github.com/astral-sh/uv) installed:
+```json
+{
+  "mcpServers": {
+    "fiftyone": {
+      "command": "uvx",
+      "args": ["fiftyone-mcp-server"]
+    }
+  }
+}
+```
+This downloads and runs the latest version automatically.
+## Usage
+After configuration, restart your AI assistant and try:
 ```
 "List all my datasets"
@@ -116,57 +178,79 @@ And then you can query directly the agent:
 "Find similar images in my dataset"
 ```
-Example of functionality:
 The server starts with 50 built-in operators. Install plugins to expand functionality - the AI can discover and install plugins automatically when needed (brain, zoo, annotation, evaluation, and more).
 ## Architecture
-**Operator-Based Design:**
+| Component              | Description                                      |
+| ---------------------- | ------------------------------------------------ |
+| **Operator System**    | 80+ FiftyOne operators through unified interface |
+| **Plugin System**      | AI discovers and installs plugins on demand      |
+| **Session System**     | Launch FiftyOne App for delegated operators      |
+| **Context Management** | Dataset, view, and selection state               |
-- Exposes 80+ FiftyOne operators through unified interface
-- Dynamic schema resolution based on current context
-- Context state management (dataset, view, selection)
+**Design Philosophy:** Minimal tool count (16 tools), maximum flexibility (full operator & plugin ecosystem).
-**Plugin Architecture:**
+## Contributing
-- AI discovers plugins on demand through `list_plugins`
-- Installs plugins automatically when needed
-- All plugin operators immediately available after installation
-- Self-expanding capability set
+We welcome contributions! Here's how to set up a local development environment.
-**Session Architecture:**
+### Local Development Setup
-- AI can launch FiftyOne App when needed for delegated operators
-- Enables background execution for compute-intensive operations
-- Automatic session management through natural conversation
+```bash
+# Clone the repository
+git clone https://github.com/AdonaiVera/fiftyone-mcp-server.git
+cd fiftyone-mcp-server
+# Install Poetry (if not installed)
+curl -sSL https://install.python-poetry.org | python3 -
-**Design Philosophy:**
+# Install dependencies
+poetry install
-- Minimal tool count (16 tools total)
-- Maximum flexibility (access to full operator & plugin ecosystem)
-- Mirrors FiftyOne App's execution model
+# Run the server locally
+poetry run fiftyone-mcp
+```
-## Development
+### Testing Your Changes
 ```bash
 # Run tests
 poetry run pytest
-# Code quality
+# Code formatting
 poetry run black -l 79 src/
+# Linting
 poetry run pylint --errors-only src/
 # Test with MCP Inspector
 npx @modelcontextprotocol/inspector poetry run fiftyone-mcp
 ```
+### Using Local Version with Claude
+To test your local changes with Claude Desktop, update your config:
+```json
+{
+  "mcpServers": {
+    "fiftyone": {
+      "command": "poetry",
+      "args": ["run", "fiftyone-mcp"],
+      "cwd": "/absolute/path/to/fiftyone-mcp-server"
+    }
+  }
+}
+```
 ## Resources
 - [FiftyOne Docs](https://docs.voxel51.com/)
 - [FiftyOne Operators](https://docs.voxel51.com/plugins/developing_plugins.html)
 - [Model Context Protocol](https://modelcontextprotocol.io)
 - [MCP Inspector](https://github.com/modelcontextprotocol/inspector)
+- [PyPI Package](https://pypi.org/project/fiftyone-mcp-server/)
 ---

fiftyone_mcp_server-0.1.2/README.md ADDED Viewed

@@ -0,0 +1,226 @@
+# FiftyOne MCP Server
+<!-- mcp-name: io.github.AdonaiVera/fiftyone-mcp-server -->
+<div align="center">
+<p align="center">
+<!-- prettier-ignore -->
+<img src="https://user-images.githubusercontent.com/25985824/106288517-2422e000-6216-11eb-871d-26ad2e7b1e59.png" height="55px"> &nbsp;
+<img src="https://user-images.githubusercontent.com/25985824/106288518-24bb7680-6216-11eb-8f10-60052c519586.png" height="50px">
+![fo_agent](https://github.com/user-attachments/assets/ffba1886-125c-4c73-ae51-a300b652cffe)
+> Control FiftyOne datasets through AI assistants using the Model Context Protocol
+[![PyPI](https://img.shields.io/pypi/v/fiftyone-mcp-server.svg)](https://pypi.org/project/fiftyone-mcp-server/)
+[![Python](https://img.shields.io/pypi/pyversions/fiftyone-mcp-server.svg)](https://pypi.org/project/fiftyone-mcp-server/)
+</p>
+</div>
+## Overview
+Enable ChatGPT and Claude to explore datasets, execute operators, and build computer vision workflows through natural language. This server exposes FiftyOne's operator framework (80+ built-in operators) through 16 MCP tools.
+## Features
+- **Dataset Management (3 tools)** - List, load, and summarize datasets
+- **Operator System (5 tools)** - Execute any FiftyOne operator dynamically
+- **Plugin Management (5 tools)** - Discover and install FiftyOne plugins
+- **Session Management (3 tools)** - Control FiftyOne App for delegated execution
+- **Natural Language Workflows** - Multi-step operations through conversation
+- **ChatGPT & Claude Compatible** - Works with desktop apps
+## Quick Start
+### Option 1: pip (Simplest)
+```bash
+pip install fiftyone-mcp-server
+```
+Then add to your AI tool config and restart:
+<details>
+<summary><b>Claude Desktop</b></summary>
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "fiftyone": {
+      "command": "fiftyone-mcp"
+    }
+  }
+}
+```
+</details>
+<details>
+<summary><b>Claude Code</b></summary>
+```bash
+claude mcp add fiftyone -- fiftyone-mcp
+```
+</details>
+<details>
+<summary><b>Cursor</b></summary>
+Add to Cursor MCP settings:
+```json
+{
+  "fiftyone": {
+    "command": "fiftyone-mcp"
+  }
+}
+```
+</details>
+<details>
+<summary><b>VSCode</b></summary>
+Add to `.vscode/mcp.json`:
+```json
+{
+  "servers": {
+    "fiftyone": {
+      "command": "fiftyone-mcp"
+    }
+  }
+}
+```
+</details>
+<details>
+<summary><b>ChatGPT Desktop</b></summary>
+Edit `~/Library/Application Support/ChatGPT/config.json`:
+```json
+{
+  "mcpServers": {
+    "fiftyone": {
+      "command": "fiftyone-mcp"
+    }
+  }
+}
+```
+</details>
+### Option 2: uvx (No Install Needed)
+If you have [uv](https://github.com/astral-sh/uv) installed:
+```json
+{
+  "mcpServers": {
+    "fiftyone": {
+      "command": "uvx",
+      "args": ["fiftyone-mcp-server"]
+    }
+  }
+}
+```
+This downloads and runs the latest version automatically.
+## Usage
+After configuration, restart your AI assistant and try:
+```
+"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"
+```
+The server starts with 50 built-in operators. Install plugins to expand functionality - the AI can discover and install plugins automatically when needed (brain, zoo, annotation, evaluation, and more).
+## Architecture
+| Component              | Description                                      |
+| ---------------------- | ------------------------------------------------ |
+| **Operator System**    | 80+ FiftyOne operators through unified interface |
+| **Plugin System**      | AI discovers and installs plugins on demand      |
+| **Session System**     | Launch FiftyOne App for delegated operators      |
+| **Context Management** | Dataset, view, and selection state               |
+**Design Philosophy:** Minimal tool count (16 tools), maximum flexibility (full operator & plugin ecosystem).
+## Contributing
+We welcome contributions! Here's how to set up a local development environment.
+### Local Development Setup
+```bash
+# Clone the repository
+git clone https://github.com/AdonaiVera/fiftyone-mcp-server.git
+cd fiftyone-mcp-server
+# Install Poetry (if not installed)
+curl -sSL https://install.python-poetry.org | python3 -
+# Install dependencies
+poetry install
+# Run the server locally
+poetry run fiftyone-mcp
+```
+### Testing Your Changes
+```bash
+# Run tests
+poetry run pytest
+# Code formatting
+poetry run black -l 79 src/
+# Linting
+poetry run pylint --errors-only src/
+# Test with MCP Inspector
+npx @modelcontextprotocol/inspector poetry run fiftyone-mcp
+```
+### Using Local Version with Claude
+To test your local changes with Claude Desktop, update your config:
+```json
+{
+  "mcpServers": {
+    "fiftyone": {
+      "command": "poetry",
+      "args": ["run", "fiftyone-mcp"],
+      "cwd": "/absolute/path/to/fiftyone-mcp-server"
+    }
+  }
+}
+```
+## Resources
+- [FiftyOne Docs](https://docs.voxel51.com/)
+- [FiftyOne Operators](https://docs.voxel51.com/plugins/developing_plugins.html)
+- [Model Context Protocol](https://modelcontextprotocol.io)
+- [MCP Inspector](https://github.com/modelcontextprotocol/inspector)
+- [PyPI Package](https://pypi.org/project/fiftyone-mcp-server/)
+---
+Built with [FiftyOne](https://voxel51.com/fiftyone) and [Model Context Protocol](https://modelcontextprotocol.io)

{fiftyone_mcp_server-0.1.0 → fiftyone_mcp_server-0.1.2}/pyproject.toml RENAMED Viewed

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "fiftyone-mcp-server"
-version = "0.1.0"
+version = "0.1.2"
 description = "MCP server exposing FiftyOne dataset analysis tools"
 authors = ["Adonai Vera <adonai.vera@gmail.com>"]
 license = "MIT"
@@ -16,12 +16,11 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
-    "Topic :: Scientific/Engineering :: Image Recognition",
 ]
 packages = [{include = "fiftyone_mcp", from = "src"}]

fiftyone_mcp_server-0.1.0/README.md DELETED Viewed

@@ -1,142 +0,0 @@
-# FiftyOne MCP Server
-<div align="center">
-<p align="center">
-<!-- prettier-ignore -->
-<img src="https://user-images.githubusercontent.com/25985824/106288517-2422e000-6216-11eb-871d-26ad2e7b1e59.png" height="55px"> &nbsp;
-<img src="https://user-images.githubusercontent.com/25985824/106288518-24bb7680-6216-11eb-8f10-60052c519586.png" height="50px">
-![fo_agent](https://github.com/user-attachments/assets/ffba1886-125c-4c73-ae51-a300b652cffe)
-> Control FiftyOne datasets through AI assistants using the Model Context Protocol
-</p>
-</div>
-## Overview
-Enable ChatGPT and Claude to explore datasets, execute operators, and build computer vision workflows through natural language. This server exposes FiftyOne's operator framework (80+ built-in operators) through 16 MCP tools.
-## Features
-- **Dataset Management (3 tools)** - List, load, and summarize datasets
-- **Operator System (5 tools)** - Execute any FiftyOne operator dynamically
-  - Context management (dataset/view/selection)
-  - Operator discovery and schema resolution
-  - Dynamic execution interface
-- **Plugin Management (5 tools)** - Discover and install FiftyOne plugins
-  - List available plugins and their operators
-  - Install plugins from GitHub on demand
-  - Enable/disable plugins dynamically
-- **Session Management (3 tools)** - Control FiftyOne App for delegated execution
-  - Launch/close FiftyOne App server
-  - Required for background operators (brain, evaluation, etc.)
-  - Session info and status monitoring
-- **Natural Language Workflows** - Multi-step operations through conversation
-- **ChatGPT & Claude Compatible** - Works with desktop apps
-## Installation
-```bash
-git clone https://github.com/AdonaiVera/fiftyone-mcp-server.git
-cd fiftyone-mcp-server
-poetry install
-```
-**Requirements:** Python 3.10-3.13, Poetry, FiftyOne
-## Configuration
-Add to MCP config:
-- ChatGPT: `~/Library/Application Support/ChatGPT/config.json`
-- Claude: `~/Library/Application Support/Claude/claude_desktop_config.json`
-```json
-{
-  "mcpServers": {
-    "fiftyone": {
-      "command": "poetry",
-      "args": ["run", "fiftyone-mcp"],
-      "cwd": "/absolute/path/to/fiftyone-mcp-server"
-    }
-  }
-}
-```
-Restart your AI assistant.
-## Usage
-```
-# Run
-poetry run fiftyone-mcp
-```
-And then you can query directly the agent:
-```
-"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"
-```
-Example of functionality:
-The server starts with 50 built-in operators. Install plugins to expand functionality - the AI can discover and install plugins automatically when needed (brain, zoo, annotation, evaluation, and more).
-## Architecture
-**Operator-Based Design:**
-- Exposes 80+ FiftyOne operators through unified interface
-- Dynamic schema resolution based on current context
-- Context state management (dataset, view, selection)
-**Plugin Architecture:**
-- AI discovers plugins on demand through `list_plugins`
-- Installs plugins automatically when needed
-- All plugin operators immediately available after installation
-- Self-expanding capability set
-**Session Architecture:**
-- AI can launch FiftyOne App when needed for delegated operators
-- Enables background execution for compute-intensive operations
-- Automatic session management through natural conversation
-**Design Philosophy:**
-- Minimal tool count (16 tools total)
-- Maximum flexibility (access to full operator & plugin ecosystem)
-- Mirrors FiftyOne App's execution model
-## Development
-```bash
-# Run tests
-poetry run pytest
-# Code quality
-poetry run black -l 79 src/
-poetry run pylint --errors-only src/
-# Test with MCP Inspector
-npx @modelcontextprotocol/inspector poetry run fiftyone-mcp
-```
-## Resources
-- [FiftyOne Docs](https://docs.voxel51.com/)
-- [FiftyOne Operators](https://docs.voxel51.com/plugins/developing_plugins.html)
-- [Model Context Protocol](https://modelcontextprotocol.io)
-- [MCP Inspector](https://github.com/modelcontextprotocol/inspector)
----
-Built with [FiftyOne](https://voxel51.com/fiftyone) and [Model Context Protocol](https://modelcontextprotocol.io)