Metadata-Version: 2.4
Name: creativai-mcp
Version: 0.1.1
Summary: MCP server for the CreativAI Video Intelligence Platform
Author-email: CreativAI <support@creativai.io>
License: Proprietary
Keywords: ai,creativai,mcp,model-context-protocol,video
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: creativai>=0.1
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.0
Requires-Dist: python-dotenv>=1.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-mock>=3.12; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# creativai-mcp

MCP (Model Context Protocol) server for the [CreativAI](https://creativ-ai.com) Video Intelligence Platform.

Connect any MCP-compatible AI assistant (Claude, Cursor, VS Code Copilot, etc.) directly to your CreativAI video library — search, index, extract knowledge, and manage collections through natural language.

## Installation

```bash
pip install creativai-mcp
```

## Quick Start

```bash
creativai-mcp --api-key YOUR_API_KEY
```

Or set the environment variable:

```bash
export CREATIVAI_API_KEY=YOUR_API_KEY
creativai-mcp
```

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "creativai": {
      "command": "creativai-mcp",
      "args": ["--api-key", "YOUR_API_KEY"]
    }
  }
}
```

### VS Code / GitHub Copilot

```json
{
  "mcp": {
    "servers": {
      "creativai": {
        "type": "stdio",
        "command": "creativai-mcp",
        "args": ["--api-key", "YOUR_API_KEY"]
      }
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `list_collections` | List all video collections |
| `get_collection` | Get collection details |
| `list_media` | List media in a collection |
| `search_videos` | Semantic search across your library |
| `start_indexing` | Index a video for AI search |
| `get_indexing_status` | Check indexing progress |
| `cancel_indexing` | Cancel an in-progress indexing job |
| `extract_knowledge` | Extract structured knowledge from video |
| `list_data_plates` | List all data plates |
| `get_data_plate_segments` | Get segments from a data plate |
| `list_organizations` | List organizations |
| `list_projects` | List projects in an organization |

## Transports

**stdio** (default — for desktop AI clients):
```bash
creativai-mcp --transport stdio --api-key YOUR_API_KEY
```

**HTTP/SSE** (for remote/web clients):
```bash
creativai-mcp --transport http --host 0.0.0.0 --port 8080 --api-key YOUR_API_KEY
```

## Requirements

- Python 3.10+
- A CreativAI API key — get one at [creativ-ai.com](https://creativ-ai.com)

## License

Proprietary — © CreativAI
