compliance-trestle-mcp

Trestle MCP

MCP 服务，让你可以轻松地通过 Claude、Roo 或任何兼容 MCP 的客户端使用 compliance-trestle（OSCAL 工具）。

mcp-name: io.github.oscal-compass/compliance-trestle-mcp

入门

本项目有以下两种使用方式：

• 通过编码 Agent 使用（Roo Code）：通过 MCP 在 Roo Code 中使用 Trestle-MCP。
• 通过命令行使用（MCP 客户端）：使用 MCP 命令行客户端直接调用 Trestle-MCP。

请选择最适合你工作流的方式。

通过 RooCode 使用

1. 将以下 JSON 添加到 .roo/mcp.json（Roo 工作区）中：

   {
       "mcpServers": {
           "trestle": {
               "command": "uvx",
               "args": ["--from", "compliance-trestle-mcp", "trestle-mcp"]
           }
       }
   }
   

2. 打开 Roo，确认 MCP 面板中列出了 trestle 工具，然后按需执行。

   https://github.com/user-attachments/assets/59215549-cad9-4101-baa4-ecba77ac3904

---

通过命令行使用（MCP 客户端）

步骤 1：编写 mcp.json 配置

{
    "mcpServers": {
        "trestle": {
            "command": "uvx",
            "args": ["--from", "./trestle-mcp-tmp", "trestle-mcp"]
        }
    }
}

将其保存为当前目录中的 mcp.json。

步骤 2：列出可用工具

uvx mcp-cli tools --config-file mcp.json

示例输出（可用工具）：

6 Available Tools
┌─────────┬─────────────────────────────────┬───────────────────────────────────────────────────────────────────┐
│ Server  │ Tool                            │ Description                                                       │
├─────────┼─────────────────────────────────┼───────────────────────────────────────────────────────────────────┤
│ trestle │ trestle_init                    │ Initialize a trestle working directory.                           │
│ trestle │ trestle_import                  │ Import an existing OSCAL model into the trestle workspace.        │
│ trestle │ trestle_author_catalog_generate │ Generate Catalog controls in markdown form from a catalog         │
│ trestle │ trestle_author_profile_generate │ Generate markdown documentation set for controls defined in profile│
│ trestle │ trestle_author_profile_resolve  │ Resolve an OSCAL profile to a resolved profile catalog.           │
│ trestle │ trestle_author_profile_assemble │ Assemble markdown controls into a Profile JSON file.              │
└─────────┴─────────────────────────────────┴───────────────────────────────────────────────────────────────────┘

步骤 3：执行工具（例如 trestle_init）

启动 MCP 交互式 Shell：

uvx mcp-cli interactive --config-file mcp.json

然后运行，例如：

> execute trestle_init '{"params": {}}'

典型结果：

✓ ✅ Tool executed successfully
{
  "result": {
    ...
    "content": [
      {
        "type": "text",
        "text": "✅ Trestle workspace initialized successfully"
      }
    ]
  }
}

你会看到如下文件夹：

assessment-plans    catalogs               plan-of-action-and-milestones  system-security-plans
assessment-results  component-definitions  profiles

---

工具列表与快速参考

• trestle_init：初始化 trestle 工作区
• trestle_import：从文件或 URL 导入 OSCAL 模型（Catalog/Profile 等）
• trestle_author_catalog_generate：根据目录生成 Markdown 控件
• trestle_author_profile_generate：为配置文件生成 Markdown
• trestle_author_profile_resolve：将配置文件解析为目录
• trestle_author_profile_assemble：将 Markdown 控件组装为配置文件 JSON
• trestle_task_csv_to_oscal_cd：将 CSV 映射文件转换为 OSCAL 组件定义
• trestle_task_xlsx_to_oscal_poam：将 FedRAMP 格式的 XLSX 电子表格转换为 OSCAL 行动计划与里程碑（POA&M）
• trestle_validate：根据 OSCAL 架构（以及 trestle 的语义检查）验证独立的 OSCAL 文件（任意顶层模型，例如 POA&M）

如需高级用法，请参阅官方 compliance-trestle 文档或本仓库中的开发者文档。

故障排除与帮助

• 确保已安装 uvx，并且它位于 PATH 中。
• 如果出现命令或模块错误，请检查 mcp.json 中的 MCP 服务路径是否正确。

---

我们是云原生计算基金会（CNCF）的沙箱项目。

Linux 基金会®（TLF）拥有注册商标并使用商标。TLF 商标列表请参阅商标使用。

OSCAL Compass 是一个独立的开源项目，与美国国家标准与技术研究院（NIST）或任何其他政府机构均无关联，也未获得其认可或赞助。

OSCAL Compass 最初由 IBM 贡献。