Pixeltable MCPサーバー (開発者版)

Name: Pixeltable MCP Server (Developer Edition)
Author: pixeltable

MCPサーバーとしてのマルチモーダルAIデータインフラストラクチャ。テーブル管理、AI/MLパイプライン、依存関係管理、対話型REPLなどのための32個のツール・13個のリソース・6個のプロンプトを提供します。

Pixeltable ≥ 0.5.27 で最高のパフォーマンスを発揮するために、同期エンドポイント + uvloop を使用しています (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"
      }
    }
  }
}

2つのエントリを実行する意図がない限り、同じサーバー名を2回（ユーザー設定とプロジェクト設定で）定義しないでください。

設定を変更した後は、クライアントを再起動してください。

テスト

他のカタログに影響を与えないよう、テストには専用の 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なしでツールを呼び出したり、リソースを読み取ったり、プロンプトを試したりできます。

クイックチェック: 式 openai.chat_completions を指定したツール pixeltable_check_dependencies、print(pxt.__version__) を指定したツール execute_python、リソース pixeltable://version を試してください。

Cursor

.cursor/mcp.json の env の下に PIXELTABLE_HOME を追加します（上記の「クライアント設定」を参照）。Cursorを再起動し、サーバーが接続されていることを確認してから、MCPパネルから簡単なツールを実行してください。

CLIの健全性チェック (JSON-RPCなし)

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

--version / --help は即座に終了します。list_tools.py は登録されたツール、リソース、プロンプトを表示するだけです（インポートチェックであり、完全なMCPセッションではありません）。

ツール (32)

カテゴリ	ツール
テーブル	`create_table` · `drop_table` · `create_view` · `create_snapshot`
データ	`create_replica` · `query_table` · `insert_data` · `query` · `add_computed_column`
ディレクトリ	`create_dir` · `drop_dir` · `move`
設定	`configure_logging` · `set_datastore`
AI/ML	`create_udf` · `create_array` · `create_tools` · `connect_mcp`
依存関係	`check_dependencies` · `install_dependency`
型	`create_type` (Image, Video, Audio, Array[Float], …)
ドキュメント	`search_docs`
REPL	`execute_python` · `introspect_function` · `list_available_functions` · `install_package`
ログ	`log_bug` · `log_missing_feature` · `log_success` · `generate_bug_report` · `get_session_summary`
表示	`display_in_browser`

すべてのツールには pixeltable_ というプレフィックスが付いています（REPL/ログヘルパーを除く）。完全なdocstringは introspect_function を通じて利用可能です。

リソース (13)

URI	返される内容
`pixeltable://tables`	カウント付きの全テーブル
`pixeltable://tables/{path}`	テーブル / ビュー / スナップショットに関する情報
`pixeltable://tables/{path}/schema`	カラムスキーマ
`pixeltable://directories`	全ディレクトリ
`pixeltable://ls` / `pixeltable://ls/{path}`	ディレクトリ一覧
`pixeltable://version`	Pixeltableのバージョン
`pixeltable://config/datastore`	データストア設定
`pixeltable://types`	利用可能なデータ型
`pixeltable://functions`	登録済みPixeltable関数
`pixeltable://tools`	MCPツールリスト
`pixeltable://help`	ワークフローガイダンス
`pixeltable://diagnostics`	システムおよび依存関係の診断

プロンプト (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 docs
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 が必要です
uv tool install 後に command not found となる場合: ~/.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 に報告してください

Pixeltable MCP Server (Developer Edition)