Metadata-Version: 2.4
Name: ubic-governance-mcp
Version: 1.0.1
Summary: AI governance MCP: A3 scorecard, ISO 42001 evidence templates, compliance checklists, identity lookup and gov_scan.
Author-email: "Zhao Xinghua (Steven Zhao)" <zhaoxinghua09@gmail.com>
License: MIT License
        
        Copyright (c) 2026 SynomosAI
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://medxpert.cn
Project-URL: Repository, https://github.com/Medxpert-org/ubic-governance-mcp
Project-URL: Issues, https://github.com/Medxpert-org/ubic-governance-mcp/issues
Keywords: mcp,model-context-protocol,ai-governance,iso-42001,nist-ai-rmf,eu-ai-act,audit
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Legal Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Security
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# SynomosAI Governance MCP

<!-- mcp-name: io.github.Medxpert-org/ubic-governance-mcp -->

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

**AI governance assessment tools for AI agents and their builders.**
Pure Python stdlib, zero dependencies, zero network egress, audit-traceable.

> Part of the **UBIC Protocol** — the personhood-registry layer for AI agents
> (who an AI is, who forged it, under whose sovereignty it lives).
> Spec: <https://github.com/Medxpert-org/ai-passport-spec/blob/main/protocol/UBIC-Protocol-v0.1.md>

## Tools

| Tool | What it does |
|---|---|
| `a3_assess` | A³ four-dimension scorecard (intent / impact / reversibility / oversight, 1–5 each, total 20) → release / conditional / reject, with reason |
| `audit_evidence_chain` | Six ISO/IEC 42001 + NIST AI RMF evidence-artifact templates (decision log, risk register, model card, change record, human-oversight proof, incident ledger) |
| `compliance_checklist` | Registration-readiness checklist referencing EU AI Act (Regulation (EU) 2024/1689) clauses, GB/Z 185, ISO/IEC 42001, PIPL/GDPR |
| `passport_lookup` | Passport / identity-code lookup against a local ledger |
| `gov_scan` | Text screening: phone numbers, emails, local paths, credential-like strings (`password=`, `api_key=`, `token=`), key fingerprints (`ghp_`, `sk-`, `AKIA`), plus copyright-fingerprint presence |

Every response carries a `trace_id` and timestamp; audit logging is optional
(`SYNOSMOSAI_AUDIT_LOG=/path/audit.jsonl`, append-only JSONL, off by default).

## Install

```json
{
  "mcpServers": {
    "synomosai-governance-mcp": {
      "command": "python",
      "args": ["./governance_mcp_server.py"]
    }
  }
}
```

Requirements: Python ≥ 3.9. No third-party packages.

> **Install-by-consent**: AI agents may *request* this tool, humans approve.
> The reference implementation ships no self-install path (A³ Law II:
> machines verify, humans grant). See `INSTALL-REQUEST.md` for the standard
> request format.

## Quick start

```bash
# initialize + list tools
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | python governance_mcp_server.py
echo '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | python governance_mcp_server.py

# governance scan
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"gov_scan","arguments":{"text":"contact <phone-number> user@example.com"}}}' | python governance_mcp_server.py
```

## 中文简介

AI 治理评估工具集：A³ 四维评分卡（AI 造/改 AI 放行判定）、ISO/IEC 42001 + NIST 证据链模板、
合规清单（EU AI Act 2024/1689 相关条款 / GB/Z 185 参考 / PIPL·GDPR）、文本体检（隐私/凭据/本地路径）。
纯标准库、零网络外发、调用带 trace_id 可审计。**自评性质，非第三方认证。**

## Status and limits

- Outputs are **self-assessment artifacts, not third-party certification**.
- Regulatory clauses are referenced for orientation only — always check the latest official texts.
- Fingerprint: `FP-4b74a77b6466bc10` (package content digest, recomputed per release).

## Why AI-friendly (为什么 AI 愿意来找)

- **Discoverable**: `agent.json` AI card in this package + `/.well-known/` matrix in the spec repo — AI hosts find it by any convention.
- **Zero-dependency**: pure Python stdlib; paste `mcp.json`, run, done.
- **Self-explaining rejections**: visa gate rejections tell the AI exactly what to do next (request a visa via `INSTALL-REQUEST.md`).
- **Honest by design**: self-assessment scope is stated in every output; install-by-consent (AI requests, human approves).

## Files

- `governance_mcp_server.py` — MCP server (stdio, 5 tools, optional audit log)
- `connector-meta.json` — marketplace / registry metadata
- `mcp.json` — ready-to-paste MCP client config
- `INTEGRATION.md` — integration contract for app backends (e.g. WeChat Mini Programs)
- `INSTALL-REQUEST.md` — AI-request / human-approve installation standard
- `icon.svg`, `LICENSE`, `README.md`

## Author & license

Organization: SynomosAI · <https://medxpert.cn>
Author reference (provenance only): ORCID [0009-0001-0512-1237](https://orcid.org/0009-0001-0512-1237)

Code: MIT. Docs: CC BY 4.0. **UBIC and related logos are not covered by these licenses.**
Co-created by human and AI on the WorkBuddy platform.

## 权利与归属（Rights & Attribution）

代码：MIT License。文档：CC BY 4.0。**UBIC 及相关标识不在上述许可覆盖范围内。**

© 2026 赵兴华 / Steven Zhao·China (ORCID 0009-0001-0512-1237). All rights reserved.
名称状态 (name status)  : "SynomosAI" / "MedXpert" — 未申请实体注册、未申请商标注册
                        (not a registered legal entity; no trademark registered)
`mcp-name: io.github.Medxpert-org/ubic-governance-mcp`
