关于 odgs-mcp-server
odgs-mcp-server 将兼容 MCP 的 Agent 接入 ODGS,支持运行时数据治理验证和成熟度评估,并生成签名 S-Cert;法规编译与漂移检测等工具需许可。
主要功能
- 01运行时验证数据载荷并生成签名 S-Cert
- 02批量验证
- 03八支柱成熟度评分与差距分析
- 04ODGS 一致性检查
- 05需许可的法规编译与漂移检测
适用场景
- 01按治理规则验证数据操作
- 02评估治理成熟度并发现差距
- 03生成供合规审查的审计记录
MCP 相关
通过 stdio 向 MCP 客户端提供 ODGS 验证、评分、一致性检查及需许可的治理工具。每次运行时评估均可生成加密签名的 S-Cert。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
uvx odgs-mcp-serverODGS_PROJECT_ROOTPath to the ODGS project root containing governance definitions (judiciary/, legislative/, executive/). Defaults to the current working directory.ODGS_API_KEY密钥Metric Provenance licence key for Pro/Enterprise tier tools (compile_regulation, check_drift, detect_conflicts, narrate_audit, discover_bindings, download_pack). Omit for community-tier access (validate_payload, governance_score, list_packs, conformance_check).本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
开放数据治理标准(ODGS)——MCP 服务
在 AI Agent 边界实施确定性治理。
面向工程师: 请参阅下方的快速入门,或查看 metricprovenance.com/start 上的引导式演示。
面向合规与风险负责人: ODGS 引擎会生成加密审计跟踪(S-Cert)。
面向架构审批与认证套件: metricprovenance.com/#suite
查看实际演示
根据 8 项 ISO/IEC 38505-1 和 ISO/IEC 25012 支柱进行评分,约需十分钟——真实的 MCP 服务、真实的成熟度引擎,点击即可在 GitHub 上观看。
重要
ODGS MCP Server v0.3.4 — 成熟度诊断 + 认证套件访问
governance_score现在会调用odgs-maturity的 8 支柱 ISO/IEC 38505-1 和 ISO/IEC 25012 引擎。 法规编译、漂移检测和目录同步需要认证套件许可证。 社区版——验证、评分、符合性检查——仍然开放,无需注册。
核心功能
| 变更 | 详情 |
|---|---|
governance_score | 安装后会调用 odgs-maturity(8 支柱 ISO/IEC 38505-1 和 ISO/IEC 25012);否则回退到内置启发式方法。返回 0–100 分,并提供逐支柱差距分析。 |
| AuthGate | 通过 API 密钥验证,提供社区版/专业版/企业版访问权限。磁盘缓存有效期为 24 小时;支持通过 workspace.yaml 为气隙部署提供回退方案。 |
| 需许可的工具 | compile_regulation、check_drift、detect_conflicts、narrate_audit、discover_bindings(专业版);harvest_sovereign_rules(企业版)。 |
2026 年欧洲数据治理成熟度基准记录的 99 家企业平均成熟度为 37.6%,与当前监管预期相比存在 62.4% 的差距。
governance_score会对你的项目采用相同的评估方法。
项目简介
ODGS MCP Server 可将任何兼容 MCP 的 AI Agent 连接到 ODGS Sovereign Validation Engine。该引擎会在运行时根据治理规则评估数据操作,并生成 S-Cert(主权证书)——经过加密签名、可由机器验证的记录,用于证明治理规则已得到应用。
这是连接概率式 AI 推理与确定性治理执行的桥梁。
《欧盟 AI 法案》与高风险 AI 系统
根据 《欧盟 AI 法案》第 10 条和第 12 条运营高风险 AI 系统的组织,必须在数据流水线层面提供可证明、可审计的数据治理。S-Cert 可提供适用于监管申报格式的审计跟踪。
认证版 Sovereign Pack 和 S-Cert Registry 可通过 Metric Provenance 认证实施合作伙伴获取。如需架构评估,请访问:metricprovenance.com/#suite。
功能
- 运行时验证: 数据载荷会在调用时依据主权治理规则进行评估;每次评估都会生成一份签名的 S-Cert。
- 治理成熟度评分: 依据 ISO/IEC 38505-1 和 ISO/IEC 25012 的 8 大支柱评估(0–100),提供各支柱的差距分析,并遵循欧洲治理成熟度基准方法。
- 法规编译 (需授权):将立法文本——EU AI Act、DORA、GDPR——转换为经过验证的 ODGS 规则 JSON。
- 语义漂移检测 (需授权):识别不同版本治理制品之间的定义漂移。
- 企业目录集成 (需授权):通过 Flint Bridge 从 Databricks、Snowflake 和 Collibra 获取并生成主权规则。
快速开始
# Core validation capabilities (free, no account needed)
pip install odgs-mcp-server
# With maturity scoring
pip install odgs-mcp-server odgs-maturity
# Complete installation with LLM bridge capabilities
pip install "odgs-mcp-server[llm]"
客户端配置
服务通过标准 stdio 传输运行,可即时兼容任何 MCP 客户端。
Claude Desktop
添加到 claude_desktop_config.json:
{
"mcpServers": {
"odgs-governance": {
"command": "odgs-mcp-server",
"args": ["--transport", "stdio"],
"env": {
"ODGS_PROJECT_ROOT": "/path/to/your/odgs/project"
}
}
}
}
Cursor
添加到 .cursor/mcp.json:
{
"mcpServers": {
"odgs-governance": {
"command": "odgs-mcp-server",
"args": ["--transport", "stdio"],
"env": {
"ODGS_PROJECT_ROOT": "/path/to/your/odgs/project"
}
}
}
}
授权工具访问
法规编译、认证包和目录同步需要 Certified Pack 许可证。请在客户端配置中提供发放的 API 密钥:
"env": {
"ODGS_API_KEY": "sk-odgs-...",
"ODGS_PROJECT_ROOT": "/path/to/your/odgs/project"
}
企业部署与认证包 — 请参阅 metricprovenance.com/#suite,或阅读执行摘要:
| 版本 | 范围 | 包含内容 |
|---|---|---|
| 开源核心版 | 免费(Apache 2.0) | validate_payload、governance_score、list_packs、conformance_check——无需注册 |
| 生产试点与气隙式中心 | 企业部署 | 签名的 .odgs-bundle 法规包(EU AI Act、DORA、CSRD)、Policy Studio 和 Catalog Sync |
工具参考
社区版(免费——无需 API 密钥)
| 工具 | 描述 |
|---|---|
validate_payload | 根据 ODGS 治理规则验证数据,生成 S-Cert |
validate_batch | 在一次调用中验证多个载荷 |
list_packs | 列出可用的认证法规包 |
governance_score | 按照 ISO/IEC 38505-1 和 ISO/IEC 25012 的 8 大支柱评估治理成熟度(0–100),并提供差距分析 |
conformance_check | 运行 ODGS 一致性自检(L1/L2) |
专业版(需要 API 密钥)
| 工具 | 描述 |
|---|---|
download_pack | 下载认证法规规则包并在本地缓存 |
compile_regulation | 将法规文本转换为经过验证的 ODGS 规则 JSON |
check_drift | 检测治理定义中的语义漂移 |
detect_conflicts | 查找法规规则之间的矛盾 |
narrate_audit | 将 S-Cert 转换为易于阅读的说明 |
discover_bindings | 根据目录自动生成物理数据映射 |
企业版(需要 API 密钥)
| 工具 | 描述 |
|---|---|
harvest_sovereign_rules | (Flint Bridge)自动从数据存储中提取并生成规则——预览版,尚待根据采集器接口进行验证 |
架构
ODGS MCP 服务专为零信任、本地优先执行而设计。所有数据验证均严格在你的设备上进行。任何敏感数据都不会离开你的边界。
flowchart TB
Agent[AI Agent\nClaude/Cursor/Custom]
subgraph "ODGS MCP Server"
Auth[AuthGate]
Val[OdgsInterceptor v6]
Maturity[odgs-maturity\n8-pillar ISO 38505/25012]
LLM[OdgsLlmBridge]
Flint[Flint Bridge]
end
Reg[(S-Cert Registry\nregistry.metricprovenance.com)]
Project[(Local ODGS Project)]
Agent -- "JSON-RPC (stdio)" --> Auth
Auth -- "Validate Key (HTTPS, cached 24h)" --> Reg
Auth --> Val
Auth --> Maturity
Auth --> LLM
Auth --> Flint
Val -- "Reads Rules" --> Project
Val -- "Generates" --> SCert[S-Cert]
Maturity -- "Scores pillars" --> Project
LLM -- "Compiles Regulations" --> Project
Flint -- "Harvests Sovereign Rules" --> Project
已认证的法规包
经过加密签名的规则包,每个规则包都对应一项特定法规。规则包依据权威立法文本编译,并由 Metric Provenance 认证。
| 规则包 | 法规 | 状态 |
|---|---|---|
| EU AI Act | Regulation (EU) 2024/1689 | ✅ 已认证 |
| DORA | Digital Operational Resilience Act | ✅ 已认证 |
| GDPR | General Data Protection Regulation | ✅ 已认证 |
| CSRD | Corporate Sustainability Reporting Directive | ✅ 已认证 |
| NIS2 | Network and Information Security Directive | ✅ 已认证 |
| Basel III | Basel Committee on Banking Supervision | ✅ 已认证 |
完整目录包含 15+ 个规则包。许可与部署请访问 metricprovenance.com/#suite。
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
ODGS_PROJECT_ROOT | ODGS 治理定义的路径 | 当前目录 |
ODGS_API_KEY | Professional/Enterprise 访问所需的 API 密钥 | 无(社区版) |
ODGS_REGISTRY_URL | 用于验证密钥的注册表端点 | https://registry.metricprovenance.com |
ODGS_CACHE_DIR | 已下载规则包的本地缓存目录 | ~/.odgs/cache |
关于 ODGS
开放数据治理标准(ODGS)是一项用于确定性数据治理执行的开放协议。ODGS 正在迈向正式标准化。
- 协议规范 —
pip install odgs - PyPI 软件包
- 研究论文(SSRN 6205478)
- Metric Provenance
许可
Apache 2.0 — 请参阅 LICENSE。
协议引擎和 MCP 服务均为开源。已认证的法规包依据商业许可发布。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
