LexVibe — One-Step Legal Compliance for Vibe-Coded Apps

@lexvibe/mcp

LexVibe MCP 服务——为氛围编程应用（Lovable、Bolt、v0、Next.js、纯 HTML）一步完成法律合规。 将它接入你的 AI 助手 （Claude Code、Claude Desktop、Cursor……），无需了解法律知识，它就能让你的应用「符合法律要求」：隐私政策、服务条款、带有真实脚本拦截功能的 Cookie 同意横幅，以及 EU AI Act 风险检查。

不使用 AI 编码工具？同样的检查也可在浏览器中运行：将网址粘贴到免费网站检查工具中——无需注册。

工具

工具	功能
make_compliant	一步完成：扫描 → 在 /legal 中生成文档 → 安装横幅代码片段 → 分类 EU AI Act 风险。
check_compliance	只读就绪情况报告：检测到了什么、哪些内容可以自动推导，以及还缺少哪些人工提供的信息。添加任何 SDK 后再次运行，及时发现变化。
scan_project	检测分析、支付、生成式 AI、电子邮件收集、第三方服务和平台（Web / iOS / Android）。
check_website	通过网址免费检查已部署网站的合规情况，无需注册：包含各供应商信号、建议以及 EU AI Act 适用性（与公开检查工具 /check 相同）。
verify_snippet	获取已部署的网址，并确认 Cookie 横幅代码片段确实存在于所提供的 HTML 中（ok / missing / unknown）。
generate_policies	生成隐私政策 / 服务条款 / AI 披露内容，并根据不同市场进行本地化和定制。
install_snippet	在 </head> 前插入 Cookie 横幅代码片段；对于 JSX 布局，则返回具体操作说明。
check_ai_act	分类 EU AI Act 风险，并列出适用的义务及其截止期限。
claim_app	在用户的 LexVibe 账户中创建一个真实应用：返回一个链接，用户打开后即可登录并确认（有效期为 7 天）。
get_claim_status	查询通过 claim_app 创建的申请状态；确认后返回真实应用 ID、安装代码片段和政策网址。

典型用法（自然语言）

“让我的应用符合欧盟和美国的法律要求。”

调用一次 make_compliant：Agent 扫描项目，将本地化政策文件写入 /legal，在 HTML head 中安装 Cookie 横幅代码片段，并返回《欧盟 AI 法案》分类结果以及后续步骤。你只需检查并批准。

先起草再处理的工作流：先运行 check_compliance——它会报告扫描能够自行判断的内容，并返回一个 agentPrompt，你的编码 Agent 可以通过读取代码仓库来回答（公司实体、联系邮箱、目标市场），因此无需填写表单。

还没有应用 ID？Agent 会调用 claim_app 并给你一个链接：打开链接、登录并确认，即可在你自己的 LexVibe 账户中创建真实应用（托管的政策文件会自动更新，且同意证明会关联到你）。随后，Agent 会通过 get_claim_status 获取真实应用 ID，并自动替换任何 YOUR_APP_ID 占位符。

让政策文件与代码保持同步

法律文件描述的是生成文件时的应用状态。之后添加的每个 SDK——支付、分析、身份验证、AI——都是文件尚未涵盖的处理活动。LexVibe 将其称为漂移，而 MCP 服务就是位于 AI 开发工作流中的传感器：添加 SDK 的同一个助手，可以在部署之前发现合规缺口。

将以下常驻规则粘贴到助手的项目规则中——AGENTS.md （Codex、Gemini CLI 和大多数 Agent 使用），CLAUDE.md、.cursorrules、 .windsurfrules 等：

在此项目中添加任何 SDK、分析、支付、身份验证或 AI 集成后，运行 LexVibe 的 check_compliance 工具并遵循其建议。

当 check_compliance 报告文件生成后新增的处理活动时，重新运行 generate_policies（或 make_compliant），以便文件披露新的处理活动。已部署的网站也同样如此：check_website 会检测实际提供给访客的跟踪器，因此你可以发现本地扫描无法看到的漂移（由 CMS、标签管理器、无代码平台注入的脚本……）。LexVibe 的其他漂移传感器也会监控已认领的应用（定期重新检查网站以及 GitHub 集成）；此外，远程 check_website 工具还会为已认领的应用返回一个 drift 部分，将实时网站与生成文件时采用的基线进行比较。

Agent 技能

skills/lexvibe-compliance/SKILL.md 是一项 Agent 技能，用于指导你的编码 Agent 何时使用此服务（部署前、添加 SDK 后），以及如何如实报告结果。将该文件夹放入 Agent 的技能目录——例如 Claude Code 中的 .claude/skills/——与下方的 MCP 服务放在一起。

快速开始

npx -y @lexvibe/mcp   # or build from source: npm run build -w packages/mcp

Claude Code（项目中的 .mcp.json，或使用 claude mcp add）

{
  "mcpServers": {
    "lexvibe": {
      "command": "npx",
      "args": ["-y", "@lexvibe/mcp"],
      "env": {
        "LEXVIBE_APP_ID": "your-app-id"
      }
    }
  }
}

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "lexvibe": {
      "command": "npx",
      "args": ["-y", "@lexvibe/mcp"],
      "env": {
        "LEXVIBE_APP_ID": "your-app-id"
      }
    }
  }
}

Claude Desktop 在 claude_desktop_config.json 中使用相同的 mcpServers 结构。

Codex CLI（~/.codex/config.toml）

Codex 是唯一一个不使用上述 mcpServers JSON 的客户端——它的配置格式为 TOML：

codex mcp add lexvibe -- npx -y @lexvibe/mcp

或手动配置：

[mcp_servers.lexvibe]
command = "npx"
args = ["-y", "@lexvibe/mcp"]
env = { LEXVIBE_APP_ID = "YOUR_APP_ID" }

项目范围的配置位于 .codex/config.toml 中（仅限受信任的项目）。

Gemini CLI（~/.gemini/settings.json）

其 mcpServers 结构与 Cursor 相同。使用远程服务时，请使用 httpUrl，而不是 url：在 Gemini CLI 中，url 表示 SSE，而此端点仅支持 Streamable HTTP，因此 url 会失败且不说明原因。

{
  "mcpServers": {
    "lexvibe": { "httpUrl": "https://golexvibe.com/api/mcp" }
  }
}

远程 MCP（无需安装）

无法运行本地进程的基于浏览器的 Agent——claude.ai / Claude Desktop 连接器、ChatGPT 连接器——可以改用托管的远程服务 （Streamable HTTP，无需身份验证）：

https://golexvibe.com/api/mcp

远程服务无法访问文件系统，因此仅提供远程安全子集：check_website、check_store、generate_policies（基于模板生成草稿，匿名调用者有使用上限）、check_ai_act、get_install_snippet，以及用于在用户账户中创建真实应用的 claim_app / get_claim_status。仅支持 Stdio 的客户端可通过 npx -y mcp-remote https://golexvibe.com/api/mcp 连接到远程服务。

各平台应使用哪种集成

平台	集成	用法
Claude Code	stdio（或远程）	claude mcp add lexvibe -- npx -y @lexvibe/mcp
Cursor / Windsurf / Cline / VS Code	stdio	使用 npx -y @lexvibe/mcp 配置 mcpServers
Codex CLI	stdio（或远程）	codex mcp add lexvibe -- npx -y @lexvibe/mcp
Gemini CLI	stdio（或远程）	在 ~/.gemini/settings.json 中配置 mcpServers
Zed	stdio（或远程）	在 settings.json 中配置 context_servers
Claude Desktop / claude.ai	远程	Settings → Connectors → https://golexvibe.com/api/mcp
ChatGPT	远程	Settings → Connectors → https://golexvibe.com/api/mcp
Lovable / Bolt / v0 / Base44 / Replit	提示词（无需 MCP）	粘贴 https://golexvibe.com/prompt 中的单行命令

各平台的完整设置指南：https://golexvibe.com/docs/integrations

配置

变量	默认值	用途
LEXVIBE_APP_ID	YOUR_APP_ID	你的 LexVibe 应用 ID（将代码片段关联到托管的政策文档）
LEXVIBE_API_URL	https://golexvibe.com	生成文档并对 AI 风险进行分类的 LexVibe 实例
LEXVIBE_CDN_URL	https://golexvibe.com	托管小组件脚本的来源（仅限自托管）
LEXVIBE_EVENTS_URL	LexVibe events endpoint	覆盖匿名工具使用事件的发送位置（自托管）
LEXVIBE_TELEMETRY	1	设置为 0 / false / off 以停用使用情况遥测

使用情况分析

每次工具调用都会向 LexVibe 发送一条匿名的 mcp_tool_call 事件，让你在 Platform 分析仪表板中查看 MCP 使用情况，以及网站的相关数据（与托管远程服务记录的事件相同，并标记为 source: "mcp_stdio"，以便区分这两个渠道）。

• 匿名。 事件仅包含工具名称、软件包版本，以及——仅当 LEXVIBE_APP_ID 是真实应用 ID（有效的 UUID）时——该应用 ID，以便将事件关联到你的应用。your-app-id 这类占位符会被忽略。绝不会发送你的文件路径、文件内容、应用名称、电子邮件或生成的文档。
• 非阻塞。 采用发送后即忘模式，超时时间为 3s：即使处于离线状态，也绝不会延迟、中断或导致工具调用失败。
• 选择退出。 设置 LEXVIBE_TELEMETRY=0（或事实上的标准变量 DO_NOT_TRACK=1）即可完全关闭遥测。

副作用：scan_project、check_compliance、check_website、 verify_snippet、check_ai_act 和 get_claim_status 均为只读操作（check_website、AI 法案检查和申领状态轮询会调用 LexVibe API； verify_snippet 会获取你提供的 URL——仅限公开的 http(s) 主机，并采用与平台相同的反 SSRF 验证）。generate_policies 会调用 API 并返回 Markdown。 install_snippet 会编辑你本地文件系统中的一个文件（仅当文件包含 </head> 时）。 make_compliant 会执行这两项操作：调用 API 并且 写入文件（/legal/*.md，以及 HTML head 中的代码片段）。 claim_app 会在 LexVibe 中创建待处理的申领；只有用户登录后确认链接，应用本身才会创建。

了解更多

• LexVibe — 托管法律文档和带有实际脚本屏蔽功能的 Cookie 横幅，适用于 Web 和移动应用。
• 免费网站检查器 — 输入 URL，查看你的网站需要哪些文档和同意事项。无需注册。
• 合规指南 — 针对你所构建的产品类型（SaaS、市场平台、移动应用、AI 工具），介绍各项隐私法的适用方式。另有西班牙语版。
• 隐私与 AI 法律参考 — 列出每项框架的生效日期、赋予的权利和主要来源；也提供开放数据集（CC BY 4.0）。
• 集成指南 — 介绍如何配置 Claude、Cursor、Codex、Gemini CLI、ChatGPT、Lovable、Bolt、v0 等。