金大哥 - mcsmcp MCP 详情

article

README

🚀 Microsoft Copilot Studio 中的 Jokes MCP 服务器详解

本实验将帮助您在 Microsoft Copilot Studio 中设置 Jokes MCP Server，与 Copilot 交互获取笑话，并深入理解 MCP 服务器在 Copilot Studio 中的工作原理。通过完成实验，您可以在 Copilot Studio 集成并运行 Jokes MCP Server，还能使用不同命令从多个来源获取各类笑话。

🚀 快速开始

实验目标

本实验将指导您完成以下步骤：

在 Microsoft Copilot Studio 中设置 Jokes MCP Server
与 Copilot 进行交互以获取笑话
理解 MCP 服务器如何在 Copilot Studio 中工作

通过本实验，您将能够：

在 Copilot Studio 中集成并运行 Jokes MCP Server
使用不同的命令从多个来源获取笑话（包括 Chuck Norris、爸爸和妈妈的笑话）

实验环境

基础要求

Copilot Studio：需要 Microsoft 365 或 Visual Studio 订阅
Jokes MCP Server：基于 TypeScript SDK 构建

📦 安装指南

实验步骤

第一部分：在 Copilot Studio 中设置 Jokes MCP 服务器

步骤 1：创建新实验

打开 Microsoft Copilot Studio。
点击“新建实验”按钮，选择一个空白项目。

步骤 2：集成 Jokes MCP Server

在实验中添加一个新的模块，命名为 jokes-mcp-server。
将以下代码粘贴到该模块的编辑器中：

// 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 代理

在 Copilot Studio 中，导航到“设置” > “模型和代理”。
添加一个新的代理，指定为 jokes-mcp-server 模块。

💻 使用示例

基础用法

第二部分：测试 Jokes MCP 服务器

测试命令

在 Copilot Studio 的聊天界面中输入以下内容：

Chuck Norris 笑话

/get-chuck-joke

爸爸笑话

/get-dad-joke

Yo Mama 笑话

/get-yo-mama-joke

预期输出

Chuck Norris 笑话示例：

“为什么 Chuck Norris 不需要 GPS？因为他知道每个方向都是他的名字。”

爸爸笑话示例：

“为什么数学书总是很悲伤？因为它有太多的问题！”

Yo Mama 笑话示例：

“为什么 Yo Mama 的聚会总是很安静？因为她只邀请了她自己和她的影子！”

高级用法

第三部分：高级功能

步骤 1：查看笑话来源

输入以下命令以获取所有可用的笑话来源：

/sources

步骤 2：自定义笑话来源

在 jokes-mcp-server.ts 中添加新的笑话源。
更新代理配置以支持新的来源。

示例：添加“猫狗”笑话源

// jokes-mcp-server.ts
async function getCatDogJoke() {
    // 实现从 catdog-jokes.com 获取笑话的逻辑
}

🔧 技术细节

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

常见问题

无法获取笑话
- 检查网络连接。
- 确保目标笑话网站没有限制访问。
错误信息
- 查看控制台日志以获取详细错误信息。
- 确保所有 API 请求都已正确实现。

性能优化

添加错误处理：

async function getChuckNorrisJoke() {
    try {
        // 获取笑话的逻辑
    } catch (error) {
        console.error('获取 Chuck Norris 笑话时出错：', error);
        return '抱歉，无法获取当前笑话。';
    }
}

实现缓存机制以提高性能：

let lastChuckJoke: string | null = null;

async function getChuckNorrisJoke() {
    if (lastChuckJoke) return lastChuckJoke;
    
    // 获取新笑话并更新 lastChuckJoke
}

📚 详细文档

附加信息

工具和资源

Node.js 和 npm：用于运行和构建服务器。
Git：用于代码版本控制。

已知问题和改进计划

当前限制
- 目前仅支持三个笑话来源。
- 笑话数量有限，建议定期更新内容。
未来改进
- 添加更多笑话来源（如程序员、学校等）。
- 实现笑话分类和过滤功能。

贡献指南

如何贡献代码
- 提交拉取请求到 jokes-mcp-server 仓库。
- 确保代码符合 TypeScript 标准。
如何报告问题
- 在 GitHub 仓库中创建新议题。
- 提供详细错误信息和复现步骤。

📄 许可证

本指南中的所有内容均受 Microsoft 许可协议约束。
笔记本代码和文档版权归作者所有，转载请注明出处。

商标信息

Microsoft、Copilot Studio 和相关徽标是微软公司的注册商标。

mcsmcp