Umbraco Cms MCP Dev

🚀 更新忽略端點技能

本技能通過分析Umbraco管理API並與已實現的MCP工具進行對比，自動更新docs/analysis/IGNORED_ENDPOINTS.md文件。

🚀 快速開始

運行方式

從項目根目錄下，可通過以下兩種方式運行此技能：

• 命令行方式：運行以下命令

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

• Claude Code方式：輸入指令

Can you update the ignored endpoints documentation?

✨ 主要特性

• 從生成的Umbraco管理API TypeScript客戶端中提取所有API端點。
• 掃描工具目錄，識別哪些端點有MCP工具實現。
• 按API組對被忽略（未實現）的端點進行分類。
• 生成包含當前覆蓋統計信息的更新後的IGNORED_ENDPOINTS.md文件。
• 保留文檔中現有的理由說明部分。

💻 使用示例

基礎用法

在項目根目錄下，使用命令行運行腳本：

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

高級用法

通過Claude Code調用技能：

Can you update the ignored endpoints documentation?

📚 詳細文檔

工作原理

TypeScript腳本會對以下內容進行分析：

• API端點：通過查找所有Result類型的導出，從src/umb-management-api/api/api/umbracoManagementAPI.ts中提取。
• 已實現的工具：通過查找CreateUmbracoTool調用及其對應的API客戶端方法調用，從src/umb-management-api/tools/中掃描。
• 分類：按照常見模式（用戶、安全、包等）對被忽略的端點進行分組。

輸出內容

腳本會輸出以下內容：

• 更新後的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個工具 vs 323個端點）的原因如下：

1. 一些工具使用多個API端點（例如，publish-document-with-descendants調用2個端點）。
2. 一些端點被多個工具使用（例如，deleteDocumentById在不同上下文中被調用）。

這兩個數字都是準確的，它們衡量的是不同方面：

• 334個工具 = 向大語言模型（LLMs）公開的MCP工具。
• 323個端點 = 所使用的唯一Umbraco API端點。
• 401個總數 = 所有可用的Umbraco管理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完整實現的進度。