Sanity MCP Server

🚀 Sanity MCP サーバー

このMCPサーバーは、Sanity.ioのコンテンツとやり取りするためのツールを提供しており、Claudeデスクトップ向けに設計されています。

🚀 クイックスタート

このセクションでは、Sanity MCPサーバーのセットアップとClaudeデスクトップでの使用方法を説明します。

📦 インストール

以下の手順に従って、このサーバーをインストールしてください。

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

npm install

3. あなたのSanityの認証情報を含む .env ファイルを作成します。

SANITY_PROJECT_ID=your_project_id
SANITY_DATASET=your_dataset
SANITY_TOKEN=your_token

💻 使用例

Claudeデスクトップでこのサーバーを使用するには、以下の手順に従ってください。

1. Claudeデスクトップで、設定 > MCPサーバーに移動します。
2. 新しいサーバーを追加し、以下のように設定します。

{
  "command": "node",
  "args": ["src/sanity-mcp-server.ts"],
  "env": {
    "SANITY_PROJECT_ID": "your_project_id",
    "SANITY_DATASET": "your_dataset", 
    "SANITY_TOKEN": "your_token"
  }
}

✨ 主な機能

このサーバーで利用できるツールについて説明します。

ドキュメントの作成

Sanity内に新しいドキュメントを作成します。

パラメータ:

• type：ドキュメントのタイプ
• content：ドキュメントの内容

例:

{
  "type": "post",
  "content": {
    "title": "我的文章",
    "body": [
      {
        "_type": "block",
        "children": [
          {
            "_type": "span",
            "text": "你好，世界！"
          }
        ]
      }
    ]
  }
}

ドキュメントの編集

既存のドキュメントを編集します。

パラメータ:

• id：ドキュメントのID
• content：更新後の内容

ドキュメントの一覧表示

特定のタイプのドキュメントを一覧表示します。

パラメータ:

• type：ドキュメントのタイプ
• limit：返される最大ドキュメント数（デフォルト: 10）

スキーマの取得

既存のドキュメントに基づいてスキーマテンプレートを取得します。

注意: このツールを使用する前に、各タイプの少なくとも1つのドキュメントを手動で作成することをおすすめします。

パラメータ:

• type：ドキュメントのタイプ

💻 使用例

以下は、このサーバーのツールを使用する具体的な例です。

基本的な使用法

新しいブログ記事の作成

{
  "tool": "create-document",
  "arguments": {
    "type": "post",
    "content": {
      "title": "我的第一篇文章",
      "slug": "my-first-post",
      "body": [
        {
          "_type": "block",
          "children": [
            {
              "_type": "span",
              "text": "这是我的第一篇文章！"
            }
          ]
        }
      ]
    }
  }
}

既存の記事の編集

{
  "tool": "edit-document",
  "arguments": {
    "id": "post-id-123",
    "content": {
      "title": "更新后的标题"
    }
  }
}

最近の記事の一覧表示

{
  "tool": "list-documents",
  "arguments": {
    "type": "post",
    "limit": 5
  }
}

記事のスキーマの取得

{
  "tool": "get-schema",
  "arguments": {
    "type": "post"
  }
}