Neural Draft

Neural Draft MCP 服务（@neuraldraft/mcp）

为 AI 构建的网站提供后端：CMS、博客、预订、表单、商店和社交功能，每位客户各用一个数据库。编码助手在构建网站时配置 CMS；客户可在网页编辑器中或通过 Claude 进行编辑。

@neuraldraft/mcp 是适用于 Neural Draft 的 Model Context Protocol 服务（stdio，MIT）。使用工作区 API 密钥将其添加到 Claude Code、Cursor、Codex 或 VS Code 后，助手在构建客户网站时可以：

• 在编写任何内容之前读取品牌信息（语气、受众、颜色、字体、语言）；
• 创建带 SEO 元数据的页面，并注册可编辑的内容键和组件，让客户无需你协助，就能在 Neural Draft 编辑器中修改文字和图片；
• 按照网站自身的设计，为托管网站添加页面或子页面，并添加菜单链接；
• 设置可预约服务、图库和博客草稿，并读取产品、表单提交内容和新闻简报订阅信息；
• 通过一个服务处理多个客户工作区（适用于代理机构）。

每位客户都有独立的 Neural Draft 工作区，并拥有自己的 Postgres 数据库、API 密钥和团队。密钥只能访问其所属的工作区。

安装

你需要 Node 20+ 和工作区 API 密钥：在 Neural Draft 管理后台中，选择 Settings → For developers → API keys（ndsk_live_…）。包含免费套餐，无需信用卡。

Claude Code

claude mcp add neuraldraft-dev -e NEURALDRAFT_API_KEY=ndsk_live_... -- npx -y @neuraldraft/mcp

添加 --scope project 可将配置写入项目的 .mcp.json，并通过环境变量引用来避免将密钥提交到 git：

{
  "mcpServers": {
    "neuraldraft-dev": {
      "command": "npx",
      "args": ["-y", "@neuraldraft/mcp"],
      "env": { "NEURALDRAFT_API_KEY": "${NEURALDRAFT_API_KEY}" }
    }
  }
}

运行 /mcp 检查是否已连接。

Cursor

.cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "neuraldraft-dev": {
      "command": "npx",
      "args": ["-y", "@neuraldraft/mcp"],
      "env": { "NEURALDRAFT_API_KEY": "ndsk_live_..." }
    }
  }
}

Codex

codex mcp add neuraldraft-dev --env NEURALDRAFT_API_KEY=ndsk_live_... -- npx -y @neuraldraft/mcp

或者使用 ~/.codex/config.toml：

[mcp_servers.neuraldraft-dev]
command = "npx"
args = ["-y", "@neuraldraft/mcp"]
env = { NEURALDRAFT_API_KEY = "ndsk_live_..." }

VS Code

.vscode/mcp.json：

{
  "servers": {
    "neuraldraft-dev": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@neuraldraft/mcp"],
      "env": { "NEURALDRAFT_API_KEY": "ndsk_live_..." }
    }
  }
}

Continue

~/.continue/config.yaml：

mcpServers:
  - name: neuraldraft-dev
    command: npx
    args: ["-y", "@neuraldraft/mcp"]
    env:
      NEURALDRAFT_API_KEY: ndsk_live_...

多个客户工作区（代理机构）

每位客户都有自己的工作区和密钥。将它们全部配置在一个服务中，然后通过 list_workspaces / switch_workspace 切换；其他所有工具都会在当前工作区中操作。

{
  "mcpServers": {
    "neuraldraft-dev": {
      "command": "npx",
      "args": ["-y", "@neuraldraft/mcp"],
      "env": {
        "NEURALDRAFT_API_KEYS": "linden-bakery=ndsk_live_...,villa-lavanda=ndsk_live_...",
        "NEURALDRAFT_WORKSPACE": "linden-bakery"
      }
    }
  }
}

NEURALDRAFT_API_KEYS 也接受 JSON 对象（{"linden-bakery":"ndsk_live_..."}）。参见多个工作区。

环境变量

变量	必填	说明
NEURALDRAFT_API_KEY	二选一	一个工作区密钥，ndsk_live_…
NEURALDRAFT_API_KEYS	二选一	多个工作区：name=key,name=key 或 JSON 对象
NEURALDRAFT_WORKSPACE	否	启动时激活的 NEURALDRAFT_API_KEYS 中的哪个工作区（默认：第一个）
NEURALDRAFT_API_URL	否	默认值 https://api.neuraldraft.io/v1
NEURALDRAFT_PROJECT_ID	否	一个密钥对应多个项目时用于覆盖设置
NEURALDRAFT_DISPLAY_NAME	否	在客户端的服务列表中显示的名称

也接受 NEURAL_DRAFT_* 拼写形式作为别名。如果密钥缺失或格式错误，服务将在启动时停止，并显示可用配置示例。切勿提交密钥。

远程 / 托管连接器

Neural Draft 也运行托管的远程 MCP 服务，无需 API 密钥，也无需安装任何内容：

https://neuraldraft.io/mcp

使用 OAuth 登录（Google 或通过电子邮件发送的验证码）的 Streamable HTTP。它适用于 Claude、ChatGPT、Codex、Claude Code、Cursor 和 VS Code，还提供本软件包不支持的功能：部署构建（deploy_site、rollback_site）、自定义域名、编辑线上网站文案、预订和可用时段、博客、社交媒体排期，以及 Batchcraft 为你的品牌制作的成品广告和短视频。我们不提供 AI 图像或视频创作服务。我们为你的品牌制作成品静态广告和短视频。

# Claude Code
claude mcp add --transport http neuraldraft https://neuraldraft.io/mcp
# Codex
codex mcp add neuraldraft --url https://neuraldraft.io/mcp && codex mcp login neuraldraft

Claude：Customize → Connectors → Add custom connector。ChatGPT：Settings → Apps → Add custom MCP server。粘贴 URL 并登录。各应用的设置说明：托管连接器。

	托管连接器	@neuraldraft/mcp（本仓库）
身份验证	登录（OAuth）	每个工作区使用一个 API 密钥
运行方式	远程，Streamable HTTP	通过 npx 在本地运行（stdio）
最适合	托管和部署网站、客户编辑、域名、博客、预订、社交媒体	接入代码库：品牌、内容键、组件、页面、图库
多个客户	登录时勾选工作区	NEURALDRAFT_API_KEYS

开发者通常会同时将两者添加到 Claude Code 或 Codex。

工具

分组	工具
工作区	list_workspaces、switch_workspace、find_workspaces
品牌	get_brand、update_brand
内容	create_translation_keys、get_content、list_content、delete_content、register_component、delete_component
页面	create_page、list_pages、get_page、update_page、delete_page、add_site_page
图像和图库	list_images、get_image、register_image、replace_image（按 URL）、delete_image、list_galleries、get_gallery、create_gallery、update_gallery、delete_gallery
博客	generate_blog_post（以品牌语气撰写草稿）、list_blog_posts、get_blog_post、update_blog_post
预订和商店	create_bookable_service、setup_booking_widget、list_products、get_product
表单	list_newsletter_subscribers、list_contact_form_submissions
账户	get_usage、get_job

generate_image 和 generate_video 仍为旧版客户端保留注册，但已停用：API 会对它们返回 410 media_generation_moved。

资源

URI	内容
brand://current	品牌语气、受众、颜色、字体、语言。生成 UI 前请先读取。
schema://blog-post	博客文章响应结构
schema://product	产品和变体结构
schema://booking	服务、预订、可用时段
conventions://editable-html	data-translate / data-image-key 标记规则
conventions://api-usage	身份验证、错误、速率限制、作业

提示词

提示词	功能
/scaffold-marketing-site	构建一个完整的营销网站并接入 Neural Draft（品牌、可编辑键、组件）
/scaffold-blog-page	在现有项目中创建 /blog 索引页和文章页
/connect-existing-site	让现有静态网站可通过 Neural Draft 编辑

完整参考：工具、资源和提示词。

试试看

读取 brand://current，为此网站构建一个带有可编辑键的主视觉区和服务介绍区，并将它们注册到 Neural Draft。

助手会读取品牌信息，编写带有 data-translate 和 data-image-key 的标记，创建键并注册这些区块，使它们显示在客户的管理后台中并可供编辑。

文档

• MCP 概览和设置
• 可编辑标记
• REST API和 TypeScript SDK @neuraldraft/sdk
• 面向开发者和代理机构

本地开发

git clone https://github.com/vbalagovic/neuraldraft-mcp.git
cd neuraldraft-mcp
npm install
npm run lint    # tsc --noEmit
npm test
npm run build   # → dist/

针对本地 API 运行：

NEURALDRAFT_API_KEY=ndsk_test_xxx NEURALDRAFT_API_URL=http://localhost:8080/v1 npm run dev

使用 MCP Inspector 检查：npx @modelcontextprotocol/inspector node dist/index.js。

该服务是 Neural Draft Project API v1 的轻量封装：每个工具对应一个或几个 REST 调用。它在运行时绝不会写入 stdout（stdio 传输）。

参与贡献

欢迎提交问题和 PR。请确保测试通过（npm test），为新工具沿用现有的 register* 辅助函数模式，并为新增功能更新上方的表格。

许可证

MIT

---

由 Neural Draft 构建。有问题请联系：[email protected]。