Norma MCP Server

确定性 AI 代码审查，附带审计记录。在代理循环内实现治理。

Norma 会在您的编码代理编写代码之前，为其提供针对已检测技术栈的规则，检查每个文件是否符合这些规则，并记录结果。相同的文件和相同的规则每次都会返回相同的判定，因此您得到的是一个可以向他人展示的记录，而不是每次运行都会变化的意见。

• 远程服务器（Streamable HTTP）：https://api.qualityclouds.ai/mcp

• 认证：OAuth。首次连接时通过浏览器登录。永久免费层级。

• 适用于 Cursor、Claude Code、Lovable、Replit 以及任何兼容 MCP 的客户端

• 覆盖的技术栈：TypeScript、JavaScript、Python、PHP、Node、React、Vite、Supabase、FastAPI、SQLAlchemy、Adobe Magento 等

功能

规则集针对特定技术栈，并会根据服务器检测到的技术栈自动激活。一次仓库扫描会激活跨六个功能领域的规则集：安全性、性能、可扩展性、可管理性、可维护性和架构。仅 Supabase 规则集就涵盖 12 条规则，包括：服务角色密钥不得出现在服务器之外、不得硬编码密钥或项目 URL、每次变更操作必须进行错误检查、不得在客户端解码 JWT、以及边缘函数上的速率限制。

服务器提供六个工具：

每次会话都会生成一份结构化记录，记录已检查、已修复和已预防的内容。您的仓库的 Production-Ready Score 和完整发现结果位于您的工作区中，网址为 norma.qualityclouds.com。

Related MCP server: Argus MCP

工作原理

连接到 Norma 的编码代理遵循以下流程：

1. link_repository：在每个工作区中首次连接时调用，先于任何其他调用。

2. get_rulesets：在任何编码任务开始时调用。

3. get_rules_for_ruleset：针对每个适用的规则集 ID 调用；绝不跳过。

4. 代理在上下文中携带这些规则编写或修改代码。

5. live_check：在创建或修改每个文件之后、继续下一步之前调用。

6. register_applied_actions：任务完成后调用，使用步骤 3 中的确切规则 ID。

若要处理现有问题而不是编写新代码，代理会调用 get_open_issues 并修复仓库最近一次完整扫描中的违规项。

5 分钟快速上手（Claude Code）

1. 添加服务器：

claude mcp add --scope user --transport http norma https://api.qualityclouds.ai/mcp

2. 检查是否已连接：

claude mcp list

3. 首次使用时，您的浏览器会打开以进行登录。免费开始，无需信用卡。

4. 在任何仓库中打开会话，让 Claude Code 根据您的编码标准审查一个文件。它会链接仓库、获取您技术栈的规则，并将结果注册回您的工作区。

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "norma": {
      "url": "https://api.qualityclouds.ai/mcp"
    }
  }
}

Cursor 会在首次连接时提示您通过浏览器登录。

Lovable

Lovable 支持将自定义 MCP 服务器作为聊天连接器，因此 Norma 无需插件即可使用。在您的项目中，打开连接器面板，添加一个名为 Norma 的自定义 MCP 服务器，服务器 URL 为 https://api.qualityclouds.ai/mcp（HTTP 传输，OAuth：首次连接时您的浏览器会打开以登录）。然后发送一条消息，Lovable 会将其作为项目的常设规则：

从现在开始，对于您创建或修改的每个文件，都通过 Norma 运行它并修复它返回的问题。

有一个步骤不是可选的：在聊天中粘贴您仓库的公共 GitHub URL，以便 Lovable 可以调用 link_repository。Lovable 自身的 git 远程是一个令牌化的 URL，它不会发送给第三方，因此在您链接之前，实时检查可以工作，但审计注册会失败。

完整指南（包括故障排除）：docs/LOVABLE.md。

链接

• 注册：norma.qualityclouds.com

• 产品：qualityclouds.ai/norma

• 社区、文档和支持：github.com/qualityclouds/community

由 Quality Clouds 构建，这是一个 AI 代码治理平台，自 2017 年以来管理着 950 多个企业平台实例。