spintax MCP 服务器

会写 spintax 的智能体需要一个裁判。MCP 服务器就是这个裁判：三个工具——validate、render、analyze——跑在参考引擎上，让模型在你看到之前先自查。同一套工具有两扇门；按约束选，而不是按喜好选。

两扇门，一个引擎

两扇门都暴露来自 @spintax/core（参考引擎）的同样三个工具，而且跑的是同一个工具模块——在一扇门上通过校验的，在另一扇门上也通过。区别只在于服务器在哪里跑、允许什么。

三个工具

• validate_spintax——诊断，带严重级别、稳定的 code 和从 1 起数的行列。没有 error 就可以放心渲染。
• render_spintax——变体，seed 保证可复现，变量表当上下文。
• analyze_spintax——模板需要什么、包含什么：引用的变量、#set 与 #def 定义、include、构件计数。

在本地运行

本地服务器只需要 Node，别无其他。把任何 MCP 客户端——Claude Code、Claude Desktop、Cursor——指向这个包：

{
  "mcpServers": {
    "spintax": { "command": "npx", "args": ["-y", "@spintax/mcp"] }
  }
}

这就是全部安装。它没有大小上限——人们真正发布的模板会超过托管的 8 KB——运行时不发起网络调用（工具在你机器上运行，而不是对着某个服务器），并且在你给它一个根目录后能从磁盘读取 #include 片段：

{
  "mcpServers": {
    "spintax": {
      "command": "npx",
      "args": ["-y", "@spintax/mcp", "--include-root", "./partials"]
    }
  }
}

变体上限由你用 --max-variants 设定（默认 50，而不是托管的 20）。同样的选项也有对应的 SPINTAX_MCP_* 环境变量，供传 env 而非 args 的客户端使用。

或者用托管端点

如果你只想试试工具、什么都不装，托管那扇门在 Claude Code 里就一行：

claude mcp add --transport http spintax https://spintax.net/mcp

它不用账号，走 HTTP 应答，并已列入官方 MCP 注册表，名为 net.spintax/mcp。代价就是那些上限——每个模板 8 KB、每次渲染 20 个变体、#include 禁用——因为它要在免费额度上为自己的 CPU 买单。完整描述在它的 server card 里。

托管这扇门够不到的地方

托管端点跑在 Cloudflare 上。在 Cloudflare 被封的地方——比如整个俄罗斯——这个 URL 根本连不上，任何配置都改不了；ru.spintax.net 上也没有它，那是个静态站点、不跑服务器。本地服务器根本不发起这种调用，所以在那里它是唯一能走的 MCP 通路——正是俄语站点搬到自己域名的同一个原因。气隙和防火墙后的机器也一样——只要包已装好：能跑 Node，就能跑这些工具。

然后呢

工具是裁判，不是作者。至于一开始怎么从模型里把模板弄出来——提示词、审阅循环、要盯的那些错误——见 用 AI 写 spintax 模板。想直接从代码里调引擎、而不走 MCP，见 四个引擎。