Pixeltable MCP Server (Developer Edition)

Мультимодальная инфраструктура данных ИИ в качестве MCP-сервера. 32 инструмента · 13 ресурсов · 6 промптов для управления таблицами, конвейерами ИИ/МО, управления зависимостями, интерактивного REPL и многого другого.

Использует синхронные эндпоинты + uvloop для обеспечения максимальной производительности с Pixeltable ≥ 0.5.27 (см. pyproject.toml).

Быстрый старт

Требуется uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Claude Code (самый простой способ) — просто скажите:

"Install https://github.com/pixeltable/mcp-server-pixeltable-developer as a uv tool and add it to your MCPs"

Ручная установка:

uv tool install --from git+https://github.com/pixeltable/mcp-server-pixeltable-developer.git mcp-server-pixeltable-developer
claude mcp add pixeltable mcp-server-pixeltable-developer   # Claude Code

Если uv предупреждает, что ~/.local/bin отсутствует в вашем PATH, выполните uv tool update-shell (или добавьте этот каталог в PATH), чтобы mcp-server-pixeltable-developer был найден. Проверьте с помощью mcp-server-pixeltable-developer --version.

Из исходного кода:

git clone https://github.com/pixeltable/mcp-server-pixeltable-developer && cd mcp-server-pixeltable-developer
uv sync

Конфигурация клиента

{
  "mcpServers": {
    "pixeltable": {
      "command": "mcp-server-pixeltable-developer",
      "env": {
        "PIXELTABLE_HOME": "/Users/{you}/.pixeltable",
        "PIXELTABLE_FILE_CACHE_SIZE_G": "10"
      }
    }
  }
}

Из исходного кода — используйте "command": "uv" с "args": ["run", "--directory", "{repo}", "python", "-m", "mcp_server_pixeltable_stio"].

Пользовательская конфигурация — ~/.cursor/mcp.json (применяется ко всем рабочим областям):

{
  "mcpServers": {
    "pixeltable-developer": {
      "command": "mcp-server-pixeltable-developer",
      "env": {
        "PIXELTABLE_HOME": "/Users/you/.pixeltable"
      }
    }
  }
}

Если Cursor сообщает command not found, используйте полный путь из uv tool update-shell / which mcp-server-pixeltable-developer, например, "command": "/Users/you/.local/bin/mcp-server-pixeltable-developer".

Разработка этого репозитория из исходного кода — опциональный файл проекта .cursor/mcp.json, чтобы сервер запускался из вашего клона (замените путь):

{
  "mcpServers": {
    "pixeltable-developer": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-server-pixeltable-developer", "python", "-m", "mcp_server_pixeltable_stio"],
      "env": {
        "PIXELTABLE_HOME": "/Users/you/.pixeltable"
      }
    }
  }
}

Не определяйте одно и то же имя сервера дважды (пользователь + проект), если вы не собираетесь запускать две записи.

Перезапустите клиент после внесения изменений в конфигурацию.

Тестирование

Используйте выделенный PIXELTABLE_HOME для тестирования, чтобы не затрагивать другие каталоги.

MCP Inspector (интерактивный)

Из клона, после uv sync:

export PIXELTABLE_HOME="$HOME/.pixeltable-mcp-test"
uv run mcp dev src/mcp_server_pixeltable_stio/server.py:mcp

Это запускает сервер и открывает MCP Inspector в вашем браузере, чтобы вы могли вызывать инструменты, читать ресурсы и пробовать промпты без IDE.

Быстрые проверки: инструмент pixeltable_check_dependencies с выражением openai.chat_completions; инструмент execute_python с print(pxt.__version__); ресурс pixeltable://version.

Cursor

Добавьте PIXELTABLE_HOME в раздел env в .cursor/mcp.json (см. Конфигурация клиента выше). Перезапустите Cursor, подтвердите подключение сервера, затем запустите простой инструмент из панели MCP.

Проверка CLI (без JSON-RPC)

mcp-server-pixeltable-developer --version
uv run python list_tools.py

--version / --help завершают работу немедленно. list_tools.py только выводит зарегистрированные инструменты, ресурсы и промпты (проверка импорта, а не полноценная сессия MCP).

Инструменты (32)

Все инструменты имеют префикс pixeltable_ (за исключением помощников REPL/логирования). Полные строки документации доступны через introspect_function.

Ресурсы (13)

Промпты (6)

pixeltable_usage_guide · getting_started · computer_vision_pipeline · rag_pipeline · video_analysis_pipeline · audio_processing_pipeline

Примеры

Create a table called movies with title, year, and rating columns → insert sample data → query ratings above 8.5

Add a computed column that runs YOLOX object detection on every image

Check what deps I need for openai.chat_completions(...) → install them

execute_python("print(pxt.list_tables())")

Документация

• Документация Pixeltable

• pixeltable-skill — маршрутизатор задач, подводные камни API (openai.vision vs chat_completions, frame_iterator, similarity(string=...) и т.д.) и примеры рабочих процессов, соответствующие текущему Pixeltable

Архитектура

src/mcp_server_pixeltable_stio/
  server.py            FastMCP server, tool/resource/prompt registration, uvloop activation
  core/
    tables.py          Table CRUD, views, snapshots, replicas, queries, computed columns
    directories.py     Directory CRUD, listing, moving
    dependencies.py    Dependency checking, unified installer, diagnostics
    udf.py             UDF creation, type system, LLM tool wrappers, MCP connections
    helpers.py         Config, version, docs search, shared utilities
    resources.py       Read-only MCP resource handlers
  prompt.py            Prompt templates for common workflows
  repl_functions.py    Persistent Python REPL, introspection, package management
  canvas_server.py     Browser canvas for rich content display

Устранение неполадок

• Перезапустите клиент после любого изменения конфигурации

• Требуются Python 3.10+ и uv

• command not found после uv tool install: убедитесь, что ~/.local/bin находится в PATH (uv tool update-shell), или вызывайте по полному пути; проверьте с помощью mcp-server-pixeltable-developer --version

• Убедитесь, что PIXELTABLE_HOME указывает на существующую директорию

• Используйте log_bug(...) / generate_bug_report() для структурированного отслеживания проблем

• Сообщайте о проблемах на github.com/pixeltable/mcp-server-pixeltable-developer