Sanity MCP

🔮 Sanity MCP服务器

Sanity弃用的自托管Sanity MCP。 完整的CRUD、原子事务、引用跟踪和官方服务器没有的工具。

](https://www.npmjs.com/package/@purple-horizons/sanity-mcp) 

______________________________________________________________________

为什么存在

Sanity的官方MCP服务器(@sanity/mcp-server)是 归档。他们希望您在以下位置使用他们的托管解决方案 mcp.sanity.io 使用OAuth。

如果你愿意，那很好：

• 每个AI工具的OAuth流程
• 对Sanity基础设施的依赖
• 无离线或气隙使用
• 无论他们决定公开什么工具

此MCP为您提供：

• 🔑 简单令牌认证——一个环境变量，完成
• 🏠 自托管——可在任何地方运行，无外部依赖
• 🛠️ 更多工具——参考跟踪、差异、历史、批量操作
• ⚡ 离线工作——无需OAuth舞蹈，无需托管服务

______________________________________________________________________

快速开始

npx @purple-horizons/sanity-mcp

或全局安装：

npm install -g @purple-horizons/sanity-mcp

MCP配置

添加到您的Claude桌面、光标或VS代码配置中：

{
  "mcpServers": {
    "sanity": {
      "command": "npx",
      "args": ["@purple-horizons/sanity-mcp"],
      "env": {
        "SANITY_PROJECT_ID": "your-project-id",
        "SANITY_DATASET": "production",
        "SANITY_TOKEN": "sk-your-token"
      }
    }
  }
}

______________________________________________________________________

工具

📖 读取操作

✏️ 写入操作

🚀 独特的工具（不在Sanity的官方MCP中）

______________________________________________________________________

是什么让这更好

1.参考跟踪

在删除该图像资源之前，您可能想知道它的用途：

sanity_references id="image-abc123"
→ Shows all 47 blog posts using that image

Sanity的官方MCP没有这个。你会发现困难的方式。

2.文件困难

内容编辑器进行了更改。发生了什么变化？

sanity_diff idA="drafts.post-xyz" idB="post-xyz"
→ Shows exactly which fields differ

发布前请查看差异。或者比较任何两份文件。

3.原子散装操作

更新50个文档，它们都需要一起成功吗？一笔交易：

sanity_bulk operations=[
  { "patch": { "id": "post-1", "set": { "featured": true }}},
  { "patch": { "id": "post-2", "set": { "featured": false }}},
  ...
]
→ All or nothing. No partial states.

随着 dryRun: true，执行前验证。

4.草案状态概览

有草稿吗？它出版了吗？两者都有？

sanity_draft_status id="post-abc123"
→ { status: "both", hasUnpublishedChanges: true }

不再手动检查 drafts.{id} 对比 {id}.

______________________________________________________________________

环境变量

获取您的令牌

1. 首选 卫生/管理
2. 选择您的项目→ API → 代币
3. 使用编辑器或更高权限添加新令牌
4. 复制并设置为 SANITY_TOKEN

______________________________________________________________________

GROQ示例

// All posts, newest first
*[_type == "post"] | order(_createdAt desc)

// Specific post by slug
*[_type == "post" && slug.current == "hello-world"][0]

// Posts with expanded author
*[_type == "post"]{
  title,
  slug,
  "author": author->name,
  "category": category->title
}

// Count by category
{
  "total": count(*[_type == "post"]),
  "published": count(*[_type == "post" && !(_id in path("drafts.**"))])
}

// Full-text search
*[_type == "post" && title match "AI*"]

______________________________________________________________________

发展

# Clone
git clone https://github.com/Purple-Horizons/sanity-mcp.git
cd sanity-mcp

# Install
npm install

# Build
npm run build

# Test
npm test

# Run locally
npm run dev

______________________________________________________________________

比较

太长，读不下去了 我们更适合自托管、开发人员工具和内容运营。如果你需要发布和带有嵌入的语义搜索，它们会更好。

______________________________________________________________________

许可证

MIT© 紫色地平线

______________________________________________________________________

链接

• Sanity GROQ文件
• MCP协议
• 紫色地平线
• 报告问题