Sanity MCP Server

基本能力

产品定位

Sanity MCP Server 是一个AI驱动的内容操作工具，旨在通过自然语言指令帮助用户创建、管理和探索Sanity项目中的内容。

核心功能

• 内容智能：AI可以探索和理解内容库
• 内容操作：通过自然语言指令自动化任务
• 模式感知：AI尊重内容结构和验证规则
• 发布管理：轻松规划和组织内容发布
• 语义搜索：基于含义而非关键词查找内容

适用场景

• 在AI支持的编辑器中进行自然语言内容操作
• 自动化内容创建和管理任务
• 语义搜索和内容探索
• 内容发布和版本管理

工具列表

• Context & Setup：初始化上下文和获取使用说明
• Document Operations：创建、更新、查询文档
• Release Management：管理内容发布
• Version Management：文档版本控制
• Dataset Management：数据集管理
• Schema Information：获取模式信息
• GROQ Support：GROQ语言支持
• Embeddings & Semantic Search：语义搜索
• Project Information：项目信息管理

常见问题解答

• 使用AI与生产数据集：当配置具有写入权限的令牌时，AI可以执行破坏性操作，建议在开发/暂存数据集上测试
• Node.js环境设置：使用Node版本管理器的用户需要创建符号链接以确保MCP服务器可以访问Node.js

使用教程

使用依赖

1. 部署Sanity Studio并生成模式清单

# 选项A：强制使用最新CLI版本（推荐）
cd /path/to/studio
SANITY_CLI_SCHEMA_STORE_ENABLED=true npx --ignore-existing sanity@latest schema deploy

1. 获取API凭证：项目ID、数据集名称和具有适当权限的API令牌

安装教程

在应用程序的MCP设置中添加以下配置：

{
  "mcpServers": {
    "sanity": {
      "command": "npx",
      "args": ["-y", "@sanity/mcp-server@latest"],
      "env": {
        "SANITY_PROJECT_ID": "your-project-id",
        "SANITY_DATASET": "production",
        "SANITY_API_TOKEN": "your-sanity-api-token"
      }
    }
  }
}

调试方式

使用MCP检查器进行调试：

npx @modelcontextprotocol/inspector -e SANITY_API_TOKEN=<token> -e SANITY_PROJECT_ID=<project_id> -e SANITY_DATASET=<ds> -e MCP_USER_ROLE=developer node path/to/build/index.js

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。