Governance

本地服务

docs.mima.works开发工具017 周前更新

文档代码仓库访问官网

关于 Governance

Governance 是一款 MCP 服务，可将 AI 治理证据从不同 Agent 和技术栈提交至 Mima。它提供就绪度检查、系统登记、证据提交及门禁建议，覆盖四项指定框架。

主要功能

01按框架查看就绪度评分
02登记 AI 系统
03列出并提交证据
04预览证据对应控制项
05检查并建议合规门禁

适用场景

01检查各框架下的治理就绪度
02登记 AI 系统并确定所需控制项
03提交证据前预览对应控制项

MCP 相关

向 MCP 客户端提供 10 种治理工具，包括就绪度查询、系统登记、证据提交和门禁检查。写入工具支持试运行。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "governance": {
      "command": "npx",
      "args": [
        "-y",
        "@mima-ai/governance-mcp"
      ],
      "env": {
        "MIMA_API_KEY": "<MIMA_API_KEY>",
        "MIMA_WORKSPACE_ID": "<MIMA_WORKSPACE_ID>"
      }
    }
  }
}

启动命令npx -y @mima-ai/governance-mcp

需要配置的环境变量

MIMA_API_KEY密钥Your Mima API key (mima_ext_...)

MIMA_WORKSPACE_IDYour Mima workspace ID (ws-...)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@mima-ai/governance-mcp0.1.13stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
payload	object	是	特定于事件的字段。未知字段会被存储，但不会获得额外控制项。对于 human_oversight：{ decision, reviewer, outcome_summary, system_prompt_version? }。对于 ai_risk_assessment：{ risk_level, risk_summary, art5_self_assessment?, mitigations? }。对于 model_evaluation：{ accuracy, robustness_score?, bias_metrics?, evaluated_by? }。对于 incident_report：{ severity, description, resolution? }。
identity	string	否	执行该操作的用户或服务身份。例如，'[email protected]'。
resource	string	否	执行操作的资源或实体。例如，'customer-id:12345'。
environment	enum	否	部署环境。服务器端默认为 'production'。production \| staging \| development
occurred_at	string	否	事件发生时间的 ISO 8601 时间戳。默认为当前时间。
record_type	enum	是	治理事件类型。映射到 SDK 的 11 种记录类型。access_review \| change_event \| vendor_risk \| policy_acknowledged \| incident_report \| ai_risk_assessment \| training_data_governance \| model_evaluation \| human_oversight \| model_drift_event \| governance_review
system_name	string	是	生成此记录的 AI 系统名称。例：'loan-scoring-v2'。仅允许字母数字、空格、连字符、下划线和点。
enforce_gates	boolean	否	若为 true，则在写入前检查所有必需的治理关卡。建议用于生产操作和高风险系统。如果某个必需关卡未通过，则会阻止写入——请使用 dry_run_attest 确认此记录是否能获得弥补差距所需的控制项；验证影响后，再调用不带 enforce_gates 的 attest。

详细介绍

@mima-ai/governance-mcp

用于 AI 治理的 MCP 服务——只需 4 行配置，即可从任意 Agent、任意技术栈向 Mima 推送合规证据。

一次工具调用即可同时映射到 EU AI Act、ISO 42001、SOC 2 和 NIST AI RMF。准备度评分会自动更新。

安装

npx @mima-ai/[email protected]

或者添加到 MCP 配置中（始终固定版本）：

{
  "mcpServers": {
    "mima-governance": {
      "command": "npx",
      "args": ["-y", "@mima-ai/[email protected]"],
      "env": {
        "MIMA_API_KEY": "mima_ext_...",
        "MIMA_WORKSPACE_ID": "ws-..."
      }
    }
  }
}

10 个工具

工具	功能
`get_posture`	整体准备度评分及各框架的细分情况
`list_systems`	所有 AI 系统——已注册与未注册
`list_evidence`	按系统和时间筛选证据记录
`dry_run_attest`	预览一项证明将满足哪些控制项
`attest`	写入 GRC 证据记录
`register_system`	根据 EU AI Act Art. 9 注册 AI 系统
`acknowledge_policy`	记录对政策的确认
`derive_controls`	根据系统描述推荐证据类型
`check_gates`	门禁通过／失败状态及退出代码
`suggest_gates`	优先级排序后的门禁建议

用法 — Claude Code

添加到 ~/.claude/settings.json：

{
  "mcpServers": {
    "mima-governance": {
      "command": "npx",
      "args": ["-y", "@mima-ai/governance-mcp"],
      "env": {
        "MIMA_API_KEY": "mima_ext_...",
        "MIMA_WORKSPACE_ID": "ws-..."
      }
    }
  }
}

然后向 Claude 提问：“检查我们的合规状况” 或 “注册这个 AI 系统，并建议我们需要哪些控制项。”

用法 — Cursor / Windsurf

添加到项目根目录下的 .cursor/mcp.json 或 .windsurf/mcp.json：

{
  "mcpServers": {
    "mima-governance": {
      "command": "npx",
      "args": ["-y", "@mima-ai/governance-mcp"],
      "env": {
        "MIMA_API_KEY": "mima_ext_...",
        "MIMA_WORKSPACE_ID": "ws-..."
      }
    }
  }
}

支持试运行

所有写入工具均支持试运行——提交之前，可预览将满足哪些控制项：

dry_run_attest({ record_type: "ai_risk_assessment", system_name: "loan-scorer" })
// → { mapped_controls: ["EUAIA_ART9", "ISO42001_6_1", "NIST_AIRF_MAP_1"] }

四个框架，一次调用

框架	涵盖内容
EU AI Act	Art. 9–15 风险管理、监督和准确性义务
ISO 42001	AI 管理体系控制项——A.6.x 风险、A.9.x 性能
SOC 2	CC3.x–CC8.x 风险、变更和事件管理
NIST AI RMF	GOVERN、MAP、MEASURE、MANAGE 职能