compliance-trestle-mcp

Trestle MCP

Claude、Roo、またはMCP準拠の任意のクライアントから、compliance-trestle（OSCAL ツール）を簡単に利用するためのMCP サーバーです。

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

はじめに

このプロジェクトは、次の2つの方法で利用できます。

• コーディングエージェント（Roo Code）からの利用：MCP経由でRoo CodeからTrestle-MCPを利用します。
• CLI（MCPクライアント）からの利用：MCP CLIクライアントを使用して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

---

CLI（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インタラクティブシェルを起動します。

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 Plan of Action and Milestones（POA&M）に変換します
• trestle_validate：単独のOSCALファイル（POA&Mなど、任意のトップレベルモデル）をOSCALスキーマ（およびtrestleのセマンティックチェック）に照らして検証します

高度な使い方については、公式のcompliance-trestleドキュメントまたはこのリポジトリの開発者向けドキュメントを参照してください。

トラブルシューティングとヘルプ

• uvxがインストールされ、PATHに設定されていることを確認してください。
• コマンドまたはモジュールのエラーが表示される場合は、mcp.json内のMCPサーバーのパスが正しいことを確認してください。

---

このプロジェクトは、Cloud Native Computing Foundationのサンドボックスプロジェクトです。

The Linux Foundation®（TLF）は登録商標を保有し、商標を使用しています。TLFの商標一覧については、商標の使用を参照してください。

OSCAL Compassは独立したオープンソースプロジェクトです。National Institute of Standards and Technology（NIST）またはその他の政府機関とは提携しておらず、承認や支援も受けていません。

OSCAL Compassは、IBMによって最初に提供されました。