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 提出任何额外问题或意见。

商标

本项目可能包含项目、产品或服务的商标或标志。经授权使用微软商标或标志需遵守并必须遵循 微软商标和品牌指南。在本项目的修改版本中使用微软商标或标志不得造成混淆或暗示微软的赞助。任何第三方商标或标志的使用需遵循这些第三方的政策。