compliance-intelligence

Compliance MCP 技能示例

一个精简且可运行的 AI Agent 技能示例，使用 TheArtOfService Compliance MCP 作为基于来源的知识层。

托管服务已列入 Smithery 和 官方 MCP 注册表，名称为 com.theartofservice/compliance-intelligence。端点：https://api.theartofservice.com/mcp（可流式传输的 HTTP，匿名访问）。

两个可运行的示例：一个用于合规研究，一个用于课程目录。这是一个参考实现。克隆它，将框架名称替换为 Agent 所需的名称，并接入 Claude / GPT / Copilot / 你自己的 Agent 运行时。采用 Apache 2.0 许可，没有任何附加条件。

功能说明

给定一个合规框架名称（默认：NIST SP 800-161），此脚本会：

1. 连接到 https://api.theartofservice.com 上的合规 API
2. 获取框架元数据
3. 获取框架中的所有控制项
4. 针对每个控制项，获取审计员的证据要求（类别、材料、常见差距、来源引用）
5. 生成结构化的 Markdown 合规简报

输出适合输入到大模型中作为上下文，也可直接交给审计员或风险团队。

此模式为何有效

该 API 背后的合规语料库依据已发布的标准文本整理，并由人工编辑，而非由大模型生成。因此，对于任何需要推理合规控制项的 Agent 而言，它都是权威的知识层。

你的 Agent 提供组织经验层（组织的具体背景、语气和工作流）。平台提供官方知识层。这种分工使最终简报具备可辩护性。

统计数据

• 723 个合规框架
• 20,400 多个控制项
• 332,000 多个跨框架映射
• 314,000 多门课程，目录无需密钥即可搜索
• 28,586 多个控制项包含结构化的审计员证据要求
• 基于来源整理、带有版本标记，每周更新

快速入门

git clone https://github.com/GJB65/compliance-mcp-skill-example.git
cd compliance-mcp-skill-example
pip install -r requirements.txt
cp .env.example .env
# Edit .env and add your TAOS_API_KEY from https://compliance.theartofservice.com/settings
python run.py "NIST SP 800-161"

脚本会将 Markdown 简报输出到 stdout。可将其重定向到文件，或通过管道传入下游 Agent。

python run.py "ISO 27001:2022" > iso_27001_brief.md

第二个示例：课程目录

run.py 回答这个框架要求什么。find_courses.py 回答另一半：用户实际上可以采取什么行动。

python find_courses.py "soc 2 evidence collection"
python find_courses.py "first 90 days as CISO" --framework "ISO 27001"
python find_courses.py --overlap "SOC 2,ISO 27001"
python find_courses.py --frameworks

无需 API 密钥。 四个目录工具免费且不限量，因为它们旨在帮助买家找到合适的课程，而不是限制数据访问量。

其中最有意思的是 --overlap。普通的产品列表无法回答“我们同时采用 SOC 2 和 ISO 27001，哪些课程能同时涵盖两者”，因为这需要进行联接，而非搜索。处于这种情况的组织不想要每个标准各上一门课程，而是希望找到重叠部分：

# Courses covering SOC 2,ISO 27001 together

### SOC 2 Type 2 Security controls in ISO 27001
- Price: $299.00 USD
- Covers: ISO 27001, SOC 2
- Buy: https://store.theartofservice.com/...

如果没有课程涵盖整个组合，系统会明确说明，并报告各标准对应的现有课程，而不是返回空列表。

请引导买家使用 buy_url 字段。该字段包含归因信息，目录据此得知销售由 Agent 促成。

获取 API 密钥

1. 在 compliance.theartofservice.com/register 免费注册。
2. 你的 API 密钥（前缀为 tas_）位于账户设置中。
3. 免费套餐：每月 100 次调用。专业版（每月 $49）：每月 10,000 次调用，超额部分按每次 $0.005 计费。
4. 有关数据许可、白标或批量定价，请参阅开发者门户。

用作 Claude 技能

此仓库中的 SKILL.md 文件采用 Claude 技能定义的结构。将此仓库放入 Claude Code 或 Claude Desktop 的技能文件夹中，Claude 就可以直接调用 run.py 并传入框架名称。

使用的 API 端点

此示例调用公共 REST Agent API。如果你更偏好使用模型上下文协议而非 REST，也可以通过 MCP 端点 https://api.theartofservice.com/mcp 获取相同的数据。

端点	用途
GET /api/agent/frameworks/{name}	框架元数据
GET /api/agent/frameworks/{name}/controls	框架中的所有控制项
GET /api/agent/controls/{code}	完整的控制项详情，包括 evidence_requirements
GET /api/agent/courses	搜索课程目录（免费，无需密钥）
GET /api/agent/courses-for-frameworks	同时涵盖两个或更多标准的课程
GET /api/agent/courses/{product_id}	单门课程的完整详情
GET /api/agent/course-frameworks	涵盖的标准及课程数量

完整工具目录：compliance.theartofservice.com/developers

许可证

Apache 2.0。请参阅 LICENSE。

贡献

欢迎提交问题和 PR。如果你构建了衍生技能（供应商风险、SOC 2 审计准备、特定框架顾问等），并希望将其添加到示例注册表中，请提交 PR，附上一行简介和仓库 URL。