mcp-copilot-studio-server-generator

Power Platform MCP 連接器產生器

產生完整的 Power Platform 自訂連接器，整合模型內容協定 (MCP) 以用於 Microsoft Copilot Studio。此提示會依照 Power Platform 連接器標準建立所有必要檔案，並支援 MCP 可串流 HTTP。

指示

建立完整的 MCP 伺服器實作，需滿足以下條件：

1. 使用 Copilot Studio MCP 模式：

   • 實作 x-ms-agentic-protocol: mcp-streamable-1.0
   • 支援 JSON-RPC 2.0 通訊協定
   • 在 /mcp 提供可串流 HTTP 端點
   • 遵循 Power Platform 連接器結構

2. 結構描述合規需求：

   • 工具輸入/輸出中不得使用參考型別（Copilot Studio 會過濾）
   • 僅使用單一型別值（不可為多型別陣列）
   • 避免列舉輸入（會被視為字串，而非列舉）
   • 使用基本型別：string、number、integer、boolean、array、object
   • 確保所有端點回傳完整 URI

3. 需包含的 MCP 元件：

   • 工具：供語言模型呼叫的函式（✅ Copilot Studio 支援）
   • 資源：工具輸出的類檔案資料（✅ Copilot Studio 支援 - 必須為工具輸出才能存取）
   • 提示：特定任務的預定義範本（❌ Copilot Studio 尚未支援）

4. 實作結構：

   /apiDefinition.swagger.json  (Power Platform 連接器結構描述)
   /apiProperties.json         (連接器中繼資料與設定)
   /script.csx                 (自訂程式碼轉換與邏輯)
   /server/                    (MCP 伺服器實作)
   /tools/                     (個別 MCP 工具)
   /resources/                 (MCP 資源處理器)
   

內容變數

• 伺服器用途：[描述 MCP 伺服器應達成的目標]
• 所需工具：[列出要實作的特定工具]
• 資源：[要提供的資源類型]
• 驗證方式：[驗證方法：none、api-key、oauth2]
• 主機環境：[Azure Function、Express.js、FastAPI 等]
• 目標 API：[要整合的外部 API]

預期輸出

產生：

1. apiDefinition.swagger.json，包含：

   • 正確的 x-ms-agentic-protocol: mcp-streamable-1.0
   • MCP 端點 POST /mcp
   • 合規的結構描述定義（無參考型別）
   • McpResponse 與 McpErrorResponse 定義

2. apiProperties.json，包含：

   • 連接器中繼資料與品牌資訊
   • 驗證設定
   • 必要時的政策範本

3. script.csx，包含：

   • 用於請求/回應轉換的自訂 C# 程式碼
   • MCP JSON-RPC 訊息處理邏輯
   • 資料驗證與處理函式
   • 錯誤處理與記錄功能

4. MCP 伺服器程式碼，包含：

   • JSON-RPC 2.0 請求處理器
   • 工具註冊與執行
   • 資源管理（作為工具輸出）
   • 正確的錯誤處理
   • Copilot Studio 相容性檢查

5. 個別工具，需滿足：

   • 僅接受基本型別輸入
   • 回傳結構化輸出
   • 必要時將資源包含在輸出中
   • 為 Copilot Studio 提供清晰描述

6. 部署設定，用於：

   • Power Platform 環境
   • Copilot Studio 代理程式整合
   • 測試與驗證

驗證檢查清單

確保產生的程式碼：

• [ ] 結構描述中無參考型別
• [ ] 所有型別欄位皆為單一型別
• [ ] 列舉透過字串搭配驗證處理
• [ ] 資源可透過工具輸出取得
• [ ] 完整的 URI 端點
• [ ] 符合 JSON-RPC 2.0 規範
• [ ] 正確的 x-ms-agentic-protocol 標頭
• [ ] McpResponse/McpErrorResponse 結構描述
• [ ] 為 Copilot Studio 提供清晰的工具描述
• [ ] 相容於生成式協調

使用範例

伺服器用途：客戶資料管理與分析
所需工具：
  - searchCustomers
  - getCustomerDetails
  - analyzeCustomerTrends
資源：
  - 客戶資料
  - 分析報告
驗證方式：oauth2
主機環境：Azure Function
目標 API：CRM 系統 REST API