mcp-sanity-images

ローカル画像をSanity CMSにアップロードする MCP サーバーです。
AI アシスタントがファイルシステムから Sanity に画像ファイルをアセットとして直接アップロードできます。

クイックスタート

1. Sanity トークンを取得する

SANITY_TOKEN 環境変数を設定するか、Sanity CLI でログインしてください。

npx sanity login

サーバーは Sanity CLI の設定からトークンを自動的に読み取ります（すべてのプラットフォームで ~/.config/sanity/config.json）。

2. Claude Code に追加する

claude mcp add sanity-images --scope user --transport stdio \
  -e SANITY_PROJECT_ID=your-project-id \
  -- npx -y mcp-sanity-images@latest

これで完了です。Claude Code を再起動すると、ツールを利用できます。各セッションでは、常に最新バージョンが自動的に実行されます。

Bun がインストールされている場合は、bunx mcp-sanity-images@latest も使用できます。

curl -Lo mcp-sanity-images https://github.com/pijusz/mcp-sanity-images/releases/latest/download/mcp-sanity-images-darwin-arm64
chmod +x mcp-sanity-images
sudo mv mcp-sanity-images /usr/local/bin/
claude mcp add sanity-images --scope user --transport stdio \
  -e SANITY_PROJECT_ID=your-project-id \
  -- /usr/local/bin/mcp-sanity-images

Invoke-WebRequest -Uri "https://github.com/pijusz/mcp-sanity-images/releases/latest/download/mcp-sanity-images-windows-x64.exe" -OutFile "$env:LOCALAPPDATA\mcp-sanity-images.exe"
claude mcp add sanity-images --scope user --transport stdio -e SANITY_PROJECT_ID=your-project-id -- "%LOCALAPPDATA%\mcp-sanity-images.exe"

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "sanity-images": {
      "command": "npx",
      "args": ["-y", "mcp-sanity-images@latest"],
      "env": {
        "SANITY_PROJECT_ID": "your-project-id"
      }
    }
  }
}

{
  "mcpServers": {
    "sanity-images": {
      "command": "/usr/local/bin/mcp-sanity-images",
      "env": {
        "SANITY_PROJECT_ID": "your-project-id"
      }
    }
  }
}

{
  "mcpServers": {
    "sanity-images": {
      "command": "%LOCALAPPDATA%\\mcp-sanity-images.exe",
      "env": {
        "SANITY_PROJECT_ID": "your-project-id"
      }
    }
  }
}

ツール

対応形式：PNG、JPG/JPEG、WebP、GIF、SVG。

設定

すべてのツールで projectId と dataset もパラメーターとして受け付け、呼び出しごとに環境変数を上書きできます。

ツールの詳細

upload_image

単一のファイルをアップロードし、アセット参照を取得します。

filePath: "/path/to/hero.png"
alt: "Hero banner"  (optional — derived from filename)

{ assetId, url, alt, reference } を返します。reference は Sanity の任意の画像フィールドにパッチを適用できる状態です。

upload_and_set

アップロードとパッチ適用を 1 回の呼び出しで行います。

filePath: "/path/to/hero.png"
documentId: "product-123"      # or "drafts.product-123" to patch the draft
fieldPath: "hero.image"

アップロード前に、ツールは <id> と drafts.<id> のどちらが存在するかを確認するため、ID が間違っていてもアップロードされません。

応答の documentId は、実際にパッチが適用されたドキュメントです。ミューテーションは returnIds=true&visibility=sync を指定して送信されるため、後続の groq_query で変更を確認できます。

batch_upload

ディレクトリ内のすべての画像をアップロードします。

directory: "/path/to/images"
recursive: true

{ uploaded, assets } を返します。一部のファイルが失敗しても、残りはアップロードされ、失敗したファイルは failed（および failedCount）に一覧表示されます。

list_images

アップロードせずに画像ファイルを一覧表示します。AI が利用可能な画像を確認するのに便利です。

directory: "/path/to/images"
recursive: true

groq_query

任意の GROQ クエリを実行します（読み取り専用）。長いクエリは自動的に POST で送信されます。upload_and_set を使用する前にドキュメント ID を見つけるのに便利です。

query: "*[_type == 'product']{_id, title, slug}"
perspective: "raw"   # optional: raw (default) | published | drafts

サーバーでは Sanity API バージョン v2025-02-19 を固定して使用します。このバージョンでは、API のデフォルトの視点が published に変更されました。このツールは、指定がない場合は raw を送信するため、以前のリリース（API v2021-10-21、デフォルトは raw）と同じ結果が得られます。

更新

npx @latest を使用する場合（推奨）：常に最新バージョンを取得できるため、手動で更新する必要はありません。

バイナリを使用する場合：サーバーは起動時に新しいリリースを確認し、古いバージョンの場合は stderr にログを出力します。

[mcp-sanity-images] WARN v0.5.0 available (current: v0.4.1). Download: https://github.com/pijusz/mcp-sanity-images/releases/latest

インストール済みのバージョンを確認します。

mcp-sanity-images --version

更新するには、新しいバイナリをダウンロードして古いものと置き換えます。

開発

Bun が必要です。

git clone https://github.com/pijusz/mcp-sanity-images.git
cd mcp-sanity-images
bun install
bun test
bun run lint      # biome check
bun run build     # compile standalone binary

ライセンス

MIT