fiftyone-mcp-server 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

{fiftyone_mcp_server-0.1.0.dist-info → fiftyone_mcp_server-0.1.2.dist-info}/METADATA

@@ -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.0.dist-info → fiftyone_mcp_server-0.1.2.dist-info}/RECORD

@@ -7,7 +7,7 @@ fiftyone_mcp/tools/operators.py,sha256=bek1o1GjOsy8o4WAtv1DcMm35wvLbi2fcsOKsnIY9
 fiftyone_mcp/tools/plugins.py,sha256=nwITl1k2cbhsP4hjuZvbwVOFe5-GQARrqghltpWOwUY,10509
 fiftyone_mcp/tools/session.py,sha256=AYBaj6pugyC1w-hHf4EZJ149Edvy0amweZeoZ4h71Fw,10721
 fiftyone_mcp/tools/utils.py,sha256=kAswqiJugRBuC4ZFaeA8mKPchDVQzic7mrSMR1zGTug,2660
-fiftyone_mcp_server-0.1.0.dist-info/METADATA,sha256=fN33anNo53vLQGV15clsqddob10M-BzYXBY4V_sF-xg,5649
-fiftyone_mcp_server-0.1.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-fiftyone_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=SaZqYMrreTAYdbR5Dtle_pMKL5hFpi95dVPWMmlDXHs,56
-fiftyone_mcp_server-0.1.0.dist-info/RECORD,,
+fiftyone_mcp_server-0.1.2.dist-info/METADATA,sha256=cveI1NVlOoH5NexWeb1oNisF2iJEtvQ5FdS9khrBuu4,6807
+fiftyone_mcp_server-0.1.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+fiftyone_mcp_server-0.1.2.dist-info/entry_points.txt,sha256=SaZqYMrreTAYdbR5Dtle_pMKL5hFpi95dVPWMmlDXHs,56
+fiftyone_mcp_server-0.1.2.dist-info/RECORD,,