Umbraco Cms MCP Dev

🚀 Update Ignored Endpoints Skill

このスキルは、Umbraco Management APIを分析し、実装されたMCPツールと比較することで、自動的に docs/analysis/IGNORED_ENDPOINTS.md ファイルを更新します。

🚀 クイックスタート

このスキルの主な流れは以下の通りです。まず、生成されたUmbraco Management APIのTypeScriptクライアントからすべてのAPIエンドポイントを抽出します。次に、ツールディレクトリをスキャンして、どのエンドポイントがMCPツールで実装されているかを特定します。そして、無視される（未実装の）エンドポイントをAPIグループごとに分類し、カバレッジ統計を含む更新された IGNORED_ENDPOINTS.md ファイルを生成します。最後に、既存の文書内の「理由（Rationale）」セクションを保持します。

✨ 主な機能

• Umbraco Management APIのTypeScriptクライアントからすべてのAPIエンドポイントを抽出します。
• ツールディレクトリをスキャンして、MCPツールによるエンドポイントの実装状況を特定します。
• 無視される（未実装の）エンドポイントをAPIグループごとに分類します。
• 現在のカバレッジ統計を含む更新された IGNORED_ENDPOINTS.md ファイルを生成します。
• 文書内の既存の「理由（Rationale）」セクションを保持します。

📦 インストール

このスキルには特別なインストール手順はありません。ただし、TypeScript環境が必要です。

💻 使用例

基本的な使用法

プロジェクトのルートディレクトリから以下のコマンドを実行します。

npx ts-node .claude/skills/update-ignored-endpoints/scripts/update-ignored-endpoints.ts

または、Claude Codeを通じて以下のように使用することもできます。

Can you update the ignored endpoints documentation?

高度な使用法

環境変数を設定することで、スクリプトの動作をカスタマイズできます。

PROJECT_ROOT=/path/to/project npx ts-node .claude/skills/update-ignored-endpoints/scripts/update-ignored-endpoints.ts

📚 ドキュメント

出力内容

スクリプトの出力は以下の通りです。

• 更新された docs/analysis/IGNORED_ENDPOINTS.md ファイル
• コンソールに概要が表示され、以下の情報が含まれます。
  • 検出された総APIエンドポイント数
  • 実装されたエンドポイント数
  • 無視されたエンドポイント数
  • APIカバレッジ率

出力例

✅ IGNORED_ENDPOINTS.md has been updated successfully!

Summary:
  Total API endpoints: 401
  Implemented (unique endpoints): 323
  Ignored: 82
  Coverage: 80.5%

Note: 334 MCP tools implement 323 unique API endpoints
      Some tools use multiple endpoints, and some endpoints are used by multiple tools.

数値の理解

ツール数とエンドポイント数が異なる理由は何ですか？

• count-mcp-tools では 334個のMCPツール （CreateUmbracoToolまたはCreateUmbracoResourceを含むファイル）があります。
• update-ignored-endpoints では、それらのツールによって呼び出される 323個の一意のAPIエンドポイント があります。

この差異（334個のツール対323個のエンドポイント）がある理由は以下の通りです。

1. 一部のツールは 複数のAPIエンドポイント を使用しています（例：publish-document-with-descendantsは2つのエンドポイントを呼び出します）。
2. 一部のエンドポイントは 複数のツールによって使用されています（例：deleteDocumentByIdは異なるコンテキストから呼び出されます）。

両方の数値は正確で、それぞれ異なる側面を測定しています。

• 334個のツール = LLMに公開されているMCPツール
• 323個のエンドポイント = 利用されている一意のUmbraco APIエンドポイント
• 401個の合計 = 利用可能なすべてのUmbraco Management APIエンドポイント
• 80.5%のカバレッジ = ツールによって実装されているAPIエンドポイントの割合

カスタマイズ

環境変数を設定することで、スクリプトの動作をカスタマイズできます。

• PROJECT_ROOT: プロジェクトのルートディレクトリを上書きします（デフォルト: /Users/philw/Projects/umbraco-mcp） 例:

PROJECT_ROOT=/path/to/project npx ts-node .claude/skills/update-ignored-endpoints/scripts/update-ignored-endpoints.ts

🔧 技術詳細

• このスキルは、型の安全性とプロジェクトとの一貫性を保つためにTypeScriptで記述されています。
• 効率的なファイルパターンマッチングのために glob パッケージを使用しています。
• 既存の文書内の「## Rationale」セクションを保持します。
• エンドポイントは名前パターンに基づいて自動的に分類されます。
• 正規表現マッチングを使用してAPIエンドポイントとツールの実装を見つけます。
• カバレッジ統計は、APIの完全実装までの進捗状況を追跡するのに役立ちます。