Mcsmcp

🚀 Microsoft Copilot Studio 中的 Jokes MCP 服務器詳解

本實驗將幫助您在 Microsoft Copilot Studio 中設置 Jokes MCP Server，與 Copilot 交互獲取笑話，並深入理解 MCP 服務器在 Copilot Studio 中的工作原理。通過完成實驗，您可以在 Copilot Studio 集成並運行 Jokes MCP Server，還能使用不同命令從多個來源獲取各類笑話。

🚀 快速開始

實驗目標

本實驗將指導您完成以下步驟：

1. 在 Microsoft Copilot Studio 中設置 Jokes MCP Server
2. 與 Copilot 進行交互以獲取笑話
3. 理解 MCP 服務器如何在 Copilot Studio 中工作

通過本實驗，您將能夠：

• 在 Copilot Studio 中集成並運行 Jokes MCP Server
• 使用不同的命令從多個來源獲取笑話（包括 Chuck Norris、爸爸和媽媽的笑話）

實驗環境

基礎要求

• Copilot Studio：需要 Microsoft 365 或 Visual Studio 訂閱
• Jokes MCP Server：基於 TypeScript SDK 構建

推薦工具

1. Node.js 和 npm：用於運行和構建服務器
2. Git：用於代碼版本控制

📦 安裝指南

實驗步驟

第一部分：在 Copilot Studio 中設置 Jokes MCP 服務器

步驟 1：創建新實驗

1. 打開 Microsoft Copilot Studio。
2. 點擊“新建實驗”按鈕，選擇一個空白項目。

步驟 2：集成 Jokes MCP Server

1. 在實驗中添加一個新的模塊，命名為 jokes-mcp-server。
2. 將以下代碼粘貼到該模塊的編輯器中：

// jokes-mcp-server.ts
import { Agent } from '@modelcontextprotocol/typescript-sdk';

const agent = new Agent();

agent.on('input', async (input) => {
    if (input.toLowerCase().includes('chuck norris')) {
        return getChuckNorrisJoke();
    } else if (input.toLowerCase().includes('dad joke')) {
        return getDadJoke();
    } else if (input.toLowerCase().includes('yo mama')) {
        return getYoMamaJoke();
    }
});

async function getChuckNorrisJoke() {
    // 實現從 chucknorris.io 獲取笑話的邏輯
}

async function getDadJoke() {
    // 實現從 icanhazdadjoke.com 獲取笑話的邏輯
}

async function getYoMamaJoke() {
    // 實現從 yomama-jokes.com 獲取笑話的邏輯
}

步驟 3：配置 MCP 代理

1. 在 Copilot Studio 中，導航到“設置” > “模型和代理”。
2. 添加一個新的代理，指定為 jokes-mcp-server 模塊。

💻 使用示例

基礎用法

第二部分：測試 Jokes MCP 服務器

測試命令

在 Copilot Studio 的聊天界面中輸入以下內容：

1. Chuck Norris 笑話

/get-chuck-joke

2. 爸爸笑話

/get-dad-joke

3. Yo Mama 笑話

/get-yo-mama-joke

預期輸出

1. Chuck Norris 笑話示例：

“為什麼 Chuck Norris 不需要 GPS？因為他知道每個方向都是他的名字。”

2. 爸爸笑話示例：

“為什麼數學書總是很悲傷？因為它有太多的問題！”

3. Yo Mama 笑話示例：

“為什麼 Yo Mama 的聚會總是很安靜？因為她只邀請了她自己和她的影子！”

高級用法

第三部分：高級功能

步驟 1：查看笑話來源

輸入以下命令以獲取所有可用的笑話來源：

/sources

步驟 2：自定義笑話來源

1. 在 jokes-mcp-server.ts 中添加新的笑話源。
2. 更新代理配置以支持新的來源。

示例：添加“貓狗”笑話源

// jokes-mcp-server.ts
async function getCatDogJoke() {
    // 實現從 catdog-jokes.com 獲取笑話的邏輯
}

🔧 技術細節

第四部分：故障排除和優化

常見問題

1. 無法獲取笑話

   • 檢查網絡連接。
   • 確保目標笑話網站沒有限制訪問。

2. 錯誤信息

   • 查看控制檯日誌以獲取詳細錯誤信息。
   • 確保所有 API 請求都已正確實現。

性能優化

1. 添加錯誤處理：

async function getChuckNorrisJoke() {
    try {
        // 獲取笑話的邏輯
    } catch (error) {
        console.error('獲取 Chuck Norris 笑話時出錯：', error);
        return '抱歉，無法獲取當前笑話。';
    }
}

2. 實現緩存機制以提高性能：

let lastChuckJoke: string | null = null;

async function getChuckNorrisJoke() {
    if (lastChuckJoke) return lastChuckJoke;
    
    // 獲取新笑話並更新 lastChuckJoke
}

📚 詳細文檔

附加信息

工具和資源

• Node.js 和 npm：用於運行和構建服務器。
• Git：用於代碼版本控制。

已知問題和改進計劃

1. 當前限制

   • 目前僅支持三個笑話來源。
   • 笑話數量有限，建議定期更新內容。

2. 未來改進

   • 添加更多笑話來源（如程序員、學校等）。
   • 實現笑話分類和過濾功能。

貢獻指南

1. 如何貢獻代碼

   • 提交拉取請求到 jokes-mcp-server 倉庫。
   • 確保代碼符合 TypeScript 標準。

2. 如何報告問題

   • 在 GitHub 倉庫中創建新議題。
   • 提供詳細錯誤信息和復現步驟。

📄 許可證

• 本指南中的所有內容均受 Microsoft 許可協議約束。
• 筆記本代碼和文檔版權歸作者所有，轉載請註明出處。

商標信息

• Microsoft、Copilot Studio 和相關徽標是微軟公司的註冊商標。