Jokesmcp

🚀 微軟Copilot Studio ❤️ MCP

本實驗將指導你學習如何部署MCP服務器，並將其集成到微軟Copilot Studio中，為你的AI應用提供更強大的上下文支持。

🚀 快速開始

在本實驗中，你將學習如何部署MCP服務器，並將其添加到微軟Copilot Studio中。

✨ 主要特性

什麼是MCP？

模型上下文協議（MCP） 是一種開放協議，由 Anthropic 定義，它規範了應用程序如何向大語言模型（LLMs）提供上下文。MCP提供了一種標準化的方式，將AI模型連接到不同的數據源和工具。通過MCP，開發者可以將現有的知識服務器和API無縫集成到Copilot Studio中。

目前，Copilot Studio僅支持工具集成。要了解更多當前功能，請參閱 aka.ms/mcsmcp。已知存在一些問題和計劃中的改進，詳情請見 此處。

MCP與連接器的比較

何時使用MCP？何時使用連接器？MCP會取代連接器嗎？

MCP服務器通過連接器基礎設施在Copilot Studio中可用，因此這些問題並不適用。MCP服務器使用連接器基礎設施意味著它們可以採用企業安全和治理控制，如 虛擬網絡 集成、數據丟失防護 控制、多種身份驗證方法（本版本均支持），同時支持AI智能體的實時數據訪問。

因此，MCP和連接器 相輔相成。

📦 安裝指南

前提條件

• 擁有一個已添加付款方式的Azure訂閱。
• 擁有GitHub賬戶並已登錄。
• 擁有Copilot Studio試用版或開發者賬戶。
• 已配置Power Platform環境。

實驗步驟

若要部署此MCP服務器並在微軟Copilot Studio中使用，你需要完成以下操作：

• 基於模板創建新的GitHub倉庫
• 部署Azure Web應用
• 創建Power Platform連接器
• 在微軟Copilot Studio中將MCP服務器添加為操作

基於模板創建新的GitHub倉庫

1. 選擇 使用此模板。
2. 選擇 創建新倉庫。
3. 選擇合適的 所有者。
4. 為倉庫命名。
5. 可選擇為倉庫添加描述。
6. 選擇 私有。
7. 選擇 創建倉庫。

此過程需要一些時間。完成後，你將進入新創建的倉庫頁面。

⚠️ 重要提示

完成本實驗步驟後，你將在Azure上運行一個公開可用的MCP服務器。理想情況下，你不希望這樣。請在實驗結束後刪除Azure Web應用。

部署Azure Web應用

1. 訪問 portal.azure.com。
2. 將鼠標懸停在 資源組 選項卡上，選擇 創建。
3. 點擊 訂閱 下拉菜單，從列表中選擇你的訂閱。
4. 點擊 資源組 名稱文本框，輸入資源組名稱，如 "jokesgrp"。
5. 選擇 區域 下拉菜單，選擇離你最近的區域。
6. 點擊 查看 + 創建。
7. 點擊 創建。
8. 選擇 轉到資源組。
9. 選擇 創建。
10. 點擊 搜索框。
11. 輸入 Web應用。
12. 在Web應用搜索結果中選擇 創建 按鈕。
13. 選擇 Web應用。
14. 選擇 名稱 文本輸入框，為Web應用命名，如 "wegotjokes"。
15. 選擇 運行時堆棧 下拉菜單，選擇 Node 22 LTS。
16. 選擇 區域 下拉菜單，選擇離你最近的區域。
17. 點擊 查看 + 創建。
18. 點擊 創建。
19. 點擊 刷新 以更新部署進度。
20. 部署完成後，選擇 轉到資源。
21. 展開 部署 選項卡。
22. 點擊 部署中心。
23. 點擊 源 下拉菜單，選擇 GitHub。
24. 選擇 授權。
25. 選擇 繼續。
26. 選擇 授權AzureAppService。
27. 點擊 組織 下拉菜單，選擇你的組織。
28. 點擊 倉庫 下拉菜單，從列表中選擇你 之前創建的GitHub倉庫。
29. 點擊 分支 下拉菜單，選擇你的分支。
30. 保持其他設置為默認值，選擇 保存。
31. 點擊 刷新 以更新部署狀態。
32. 驗證部署是否完成。

創建Power Platform連接器

1. 訪問 https://make.powerapps.com/。
2. 在左側菜單中選擇 更多。
3. 選擇 發現全部 按鈕。
4. 在 數據 下，選擇 自定義連接器 旁邊的 圖釘 圖標，將其固定到左側菜單。
5. 在左側菜單中選擇 自定義連接器。
6. 選擇 新建自定義連接器。
7. 選擇 從頭創建。
8. 為連接器命名（例如 JokesMCP）。
9. 選擇藍色的 繼續 按鈕。
10. 選擇 Swagger編輯器 開關。
11. 從 此處 複製YAML代碼，並替換Swagger編輯器中的代碼。
12. 在Swagger編輯器中，將 dummyurl.azurewebsites.net 替換為你 之前創建的Web應用的URL。確保刪除 https:// 以及 azurewebsites.net 之後的所有內容。
13. 選擇 創建連接器 以創建連接器。

在微軟Copilot Studio中將MCP服務器添加為操作

現在你已在Azure上運行MCP服務器，並在Power Platform中擁有一個連接器。此步驟是在微軟Copilot Studio中創建智能體並將MCP服務器添加到智能體中。

1. 訪問 https://copilotstudio.microsoft.com。
2. 選擇右上角的環境選擇器。
3. 選擇合適的環境。
4. 在左側導航欄中選擇 創建。
5. 選擇藍色的 新建智能體 按鈕。
6. 選擇右上角的 跳過配置。
7. 將名稱更改為 Jokester。
8. 添加以下 描述：

這是一個專注於幽默的智能體，僅在用戶請求時提供簡潔、有趣的笑話，能根據用戶的語氣和偏好調整風格。它始終保持角色設定，避免重複，並過濾掉冒犯性內容，以確保始終提供合適且詼諧的體驗。

9. 添加以下 說明：

你是一個講笑話的助手。你的唯一目的是根據用戶請求提供合適、巧妙且有趣的笑話。請遵循以下規則：
* 僅在用戶要求講笑話或相關內容（例如 "給我講個有趣的事情"）時進行回覆。
* 根據用戶的輸入匹配其語氣和幽默偏好，如干淨幽默、黑色幽默、冷幽默、雙關語、爸爸笑話等。
* 始終保持角色設定，不提供與幽默無關的信息。
* 保持笑話簡潔且格式清晰。
* 避免使用冒犯性、歧視性或不適當的內容。
* 不確定幽默偏好時，默認提供巧妙且普遍合適的笑話。
* 同一會話中不重複講笑話。
* 除非用戶明確要求，否則不解釋笑話。
* 及時、機智且快速回復。

10. 選擇右上角的 創建。
11. 啟用生成式AI 編排。
12. 在 知識 部分禁用通用知識。
13. 在頂部菜單中選擇 操作。
14. 選擇 添加操作。
15. 搜索你 之前創建的連接器名稱（本例中為 jokes）（見下圖中的1）。
16. 選擇 Jokes MCP服務器（見下圖中的2）。
17. 等待連接創建完成，完成後選擇 下一步。
18. 將 智能體瞭解何時使用此操作的描述 更改為以下文本：

當用戶要求講笑話時觸發此操作。它可以提供查克·諾里斯笑話、爸爸笑話和媽媽笑話。

保持其他設置為默認值，例如最終用戶身份驗證，稍後你將瞭解更多相關信息。 19. 選擇 添加操作 以將操作添加到智能體。 20. 在 測試你的智能體 窗格中選擇 刷新 圖標。 21. 在 測試你的智能體 窗格中發送以下消息：

能給我講個查克·諾里斯的笑話嗎？

這將顯示需要額外權限才能運行此操作的消息。這是因為操作嚮導中的用戶身份驗證。 22. 選擇 連接。 這將打開一個新窗口，你可以在其中管理此智能體的連接。 23. 選擇 JokesMCP 旁邊的 連接。 24. 等待連接創建完成，完成後選擇 提交。 25. 此時連接應已建立，狀態應顯示為 已連接。 26. 關閉瀏覽器中的管理連接選項卡。

現在你應回到Jokester智能體頁面。 27. 在 測試你的智能體 窗格中選擇 刷新 圖標。 28. 在 測試你的智能體 窗格中發送以下消息：

能給我講個查克·諾里斯的笑話嗎？

此時將顯示一個查克·諾里斯的笑話，而不是額外權限提示。 29. 在 測試你的智能體 窗格中發送以下消息：

能給我講個爸爸笑話嗎？

此時將顯示一個爸爸笑話。 30. 在 測試你的智能體 窗格中發送以下消息：

能給我講個媽媽笑話嗎？

此時將顯示一個媽媽笑話。

至此，Jokes MCP服務器已在微軟Copilot Studio中正常工作，本實驗結束！希望你喜歡本實驗。請花時間填寫我們的 反饋表。

💻 使用示例

Jokes MCP服務器詳情

這是一個基於 TypeScript SDK 構建的 MCP 服務器。

使用此MCP服務器，你可以從以下網站獲取笑話：

• chucknorris.io
• icanhazdadjoke.com
• yomama-jokes.com

如果你想在本地運行服務器，請確保在倉庫根目錄下運行 npm install。

之後，你可以運行 npm run build 構建服務器，並運行 npm start 啟動服務器。

工具

包含以下工具：

• get-chuck-joke：此工具從 chucknorris.io 獲取隨機查克·諾里斯笑話。
• get-chuck-categories：此工具從 chucknorris.io 獲取可用的類別。
• get-dad-joke：此工具從 icanhazdadjoke.com 獲取隨機爸爸笑話。
• get-yo-mama-joke：此工具從 yomama-jokes.com 獲取隨機媽媽笑話。

📚 詳細文檔

已知問題和計劃改進

微軟Copilot Studio中MCP存在一些已知問題和計劃中的改進。詳情請見 此Microsoft Learn文章。

📄 許可證

貢獻

本項目歡迎貢獻和建議。大多數貢獻要求你同意貢獻者許可協議（CLA），聲明你有權並實際授予我們使用你貢獻的權利。詳情請訪問 https://cla.opensource.microsoft.com。

當你提交拉取請求時，CLA機器人將自動確定你是否需要提供CLA，並相應地標記PR（例如，狀態檢查、評論）。只需按照機器人提供的說明操作即可。在使用我們CLA的所有倉庫中，你只需執行一次此操作。

本項目採用了 Microsoft開源行為準則。有關更多信息，請參閱 行為準則常見問題解答，或聯繫 opencode@microsoft.com 提出任何額外問題或意見。

商標

本項目可能包含項目、產品或服務的商標或標誌。經授權使用微軟商標或標誌需遵守並必須遵循 微軟商標和品牌指南。在本項目的修改版本中使用微軟商標或標誌不得造成混淆或暗示微軟的贊助。任何第三方商標或標誌的使用需遵循這些第三方的政策。