Gemmein

gemmein

Gemmein CLI 的分发主页——即 npm 上的 gemmein 包，以及其运行所需本地引擎的发布记录。

Gemmein 是 AI 构建应用值得信赖的后端：账号、数据、支付——边界由平台强制执行，而不是依赖应用代码。CLI 将这些能力带到你的机器上：npx gemmein init 会用通俗语言定义产品边界，gemmein dev 则会运行真正的本地后端，在你构建应用时强制执行这些边界。

MCP 服务

@gemmein/mcp 将完整的 Gemmein 契约作为工具提供给编码 Agent——包括构建者指南、SDK 参考、规则和错误说明，以及对应用访问边界的实时检查。其中 8 个工具为只读。check_integration 会对你的应用运行实时检查；如果提供开发密钥，它还会在开发环境中写入数据：创建两个测试用户和一条探测记录，删除该记录，并让这两个测试用户退出此前的会话。

安装到 Claude Code：

claude mcp add gemmein -- npx -y @gemmein/mcp

安装到 Claude Desktop、Cursor 或任何接受 mcpServers 配置块的客户端：

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

运行时无需设置环境变量。

提供的工具：

• guide — 完整的构建者指南，涵盖身份验证流程、七条安全规则、记录结构、链接、上传、争用和支付，以及从 docs.gemmein.com/llms-dashboard.txt 实时读取的仪表板操作步骤。
• reference — 所有 SDK 方法、准确的签名、返回结构和错误代码。
• search_docs — 在两者中进行定向搜索，以便查找特定信息。
• explain_rule — 说明任意规则的契约、适用场景和应避免的错误；也可在规划阶段提供全部七条规则的速查表。
• explain_error — 说明 GemmeinError 代码的含义，以及应如何准确处理。
• validate_collection_name — 在开始读取数据并返回空结果之前，检查集合名称是否有误。
• explain_relay — 输入 gemmein/relays/<name>.json 定义，离线查看仪表板会显示的句子，或查看指明相关字段的拒绝原因；支持 11 种动词：write_record、grant_access、revoke_access、grant_credits、email_person、call_url、fulfil_product、refund_product、grant_plan、revoke_plan 和 start_run。
• reaffirm_template — 可直接复制的 CI 测试框架。
• check_integration — 对应用自身实时运行隔离和访问检查，并返回结构化的通过／失败结果。

服务的完整源代码位于 mcp/（MIT）。这是一个独立的 Node 包：运行 cd mcp && npm install && npm run build，然后执行 node dist/index.js。它不使用 Gemmein 引擎。

文档：docs.gemmein.com/mcp。

Claude 插件

plugins/gemmein/ 是一个 Claude 插件，内置上述 MCP 服务并固定到确切版本，还包含一项技能 build-on-gemmein：它会让 Claude 阅读 Gemmein 指南、询问应用的用途、判断 Gemmein 是否适用，然后遵循第一小时流程（npx -y gemmein dev、创建集合、运行 npx gemmein sync、上线）。此仓库也同时是一个插件市场。在 Claude Code 中：

/plugin marketplace add gemmeinhq/gemmein-release
/plugin install gemmein@gemmein

插件会运行、发送和存储哪些内容，详见 plugins/gemmein/README.md。

启动器的工作方式

你安装的 npm 包是一个小型启动器，以可读源码的形式发布——shim/ 中的内容就是在你的机器上实际运行的内容。

首次运行时，它会下载 Gemmein 引擎，根据固定在此包中的 SHA-256 哈希值验证引擎，将其缓存在本地，然后运行。完成这一次下载后，所有功能都可完全离线使用。如果下载的文件未通过验证，启动器会拒绝运行。

• shim/ — gemmein npm 包（纯 JS，无需构建）
• manifest/releases.json — 每个引擎版本及其文件哈希值

许可

有意采用两种许可：

• MCP 服务（mcp/，以 @gemmein/mcp 发布）采用 MIT 许可。
• npm 启动器（shim/）采用 MIT 许可——尽管阅读、审计，随你使用。
• 下载的引擎是专有软件，受 Gemmein Engine License 约束——你可以自由运行并缓存它，用于基于 Gemmein 构建（缓存后即可离线使用，即使某个版本已停用），但不得重新分发或提取。该许可也发布在 downloads.gemmein.com/engine/LICENSE。

使用方法

npx gemmein init

文档：docs.gemmein.com · 问题咨询： [email protected]