Copilot Studio Agent Direct Line MCP

🚀 ⭐ Copilot Studio Agent Direct Line MCP Server

本项目为VS Code或VS Code Insiders提供了Copilot Studio Agent Direct Line MCP Server的便捷安装方式。它是一个基于TypeScript的项目，为Microsoft Copilot Studio Agents提供了本地MCP服务器，让你可以通过Direct Line 3.0 API直接在代码编辑器中与Copilot Studio Agents进行交互。

🚀 快速开始

若要获得最佳体验，建议使用Visual Studio Code和GitHub Copilot。若想了解如何将本MCP Server与Claude Code和Cursor等其他工具配合使用，请参阅入门文档。

前提条件

1. 安装 VS Code 或 VS Code Insiders
2. 安装 Node.js 18 及以上版本
3. 拥有启用了Direct Line 3.0的Microsoft Copilot Studio Agent
4. 获取Copilot Studio Agent的Direct Line密钥

安装

✨ 一键安装（推荐）

• 在VS Code中使用NPX安装
• 在VS Code Insiders中使用NPX安装

安装完成后，选择GitHub Copilot Agent Mode并刷新工具列表。更多关于Agent Mode的信息，请参阅 VS Code文档。

🧨 使用NPX手动安装

这种安装方法对所有Visual Studio Code用户来说都很简单。

在项目中添加一个 .vscode/mcp.json 文件，并包含以下内容：

{
  "inputs": [
    {
      "id": "direct_line_secret",
      "type": "promptString",
      "description": "Direct Line secret key from your Copilot Studio Agent"
    }
  ],
  "servers": {
    "copilot-studio-agent-direct-line-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "copilot-studio-agent-direct-line-mcp"],
      "env": {
        "DIRECT_LINE_SECRET": "${input:direct_line_secret}"
      }
    }
  }
}

保存文件后，在MCP Server面板中点击“开始”。

在聊天中，切换到 Agent Mode。

点击“选择工具”并选择可用的工具。

打开GitHub Copilot Chat并尝试输入类似 Start a conversation with my Copilot Studio Agent 的提示。首次执行工具时，系统会提示你输入Direct Line密钥。

💥 强烈建议在项目中创建一个 .github/copilot-instructions.md 文件，这将提升你在GitHub Copilot Chat中使用Copilot Studio MCP Server的体验。 你可以在Copilot说明文件中添加 “This project uses Microsoft Copilot Studio Agents. Always check to see if the Copilot Studio MCP server has a tool relevant to the user's request” 作为起始内容。

有关其他安装方法（包括本地开发设置），请参阅 入门文档。

✨ 主要特性

• ✅ Direct Line 3.0集成 - 全面支持Microsoft Bot Framework Direct Line API
• ✅ 令牌管理 - 自动缓存令牌并主动刷新
• ✅ 会话状态管理 - 管理会话生命周期，空闲超时时间为30分钟
• ✅ MCP工具 - 提供四个与代理交互的工具：send_message、start_conversation、end_conversation、get_conversation_history
• ✅ 全面的错误处理 - 11种专门的错误类型，支持OAuth特定的重试策略和MCP错误转换
• ✅ 断路器模式 - 智能故障分类，将用户错误排除在电路状态之外
• ✅ 重试逻辑 - 带抖动的指数退避算法，支持OAuth感知的重试策略
• ✅ 输入验证 - 使用Zod模式进行类型安全验证
• ✅ 安全性 - 在日志中屏蔽密钥，安全配置环境，不进行磁盘持久化
• ✅ HTTP传输模式 - 可选的HTTP服务器，支持Azure Entra ID OAuth身份验证
• ✅ 测试套件 - 45多个测试用例，关键组件覆盖率超过80%
• ✅ 生产就绪 - 提供Azure Container Apps、Docker、Kubernetes的部署模板

⚒️ 支持的工具

你可以使用以下工具与Copilot Studio Agent进行交互：

• send_message：向Copilot Studio Agent发送消息并接收响应。
• start_conversation：与代理开始新的会话，可选择附带初始消息。
• end_conversation：结束会话并清理资源。
• get_conversation_history：检索会话的消息历史记录。

📚 详细文档

📺 概述

Copilot Studio Agent Direct Line MCP Server将Microsoft Copilot Studio Agent的上下文引入到你的开发环境中。你可以尝试以下提示：

• "Start a conversation with my Copilot Studio Agent"
• "Ask my agent about product sizing"
• "Send a message to the agent: What are your capabilities?"
• "Get the conversation history"
• "End the current conversation"

🏆 设计理念

Copilot Studio Agent Direct Line MCP Server采用简洁、简单、专注且易用的工具构建，每个工具都针对特定场景设计。我们有意避免使用试图实现过多功能的复杂工具。目标是在Direct Line 3.0 API之上提供一个轻量级的抽象层，使代理交互变得直接，并让语言模型处理复杂的推理。

📝 故障排除

若遇到常见问题或需要查看日志，请参阅 故障排除指南。

🎩 示例与最佳实践

• 探索示例提示和使用模式，请参阅 示例文档。
• 详细的工具参考和使用指南，请参阅 使用指南。

🙋‍♀️ 常见问题解答

有关Copilot Studio Agent Direct Line MCP Server的常见问题解答，请参阅 常见问题文档。

📌 贡献

我们欢迎贡献！在预览期间，请针对错误、增强功能或文档改进提交问题。

有关以下内容，请参阅 贡献指南：

• 🛠️ 开发设置
• ✨ 添加新功能
• 📝 代码风格与测试
• 🔄 拉取请求流程

🤝 行为准则

本项目遵循标准的开源社区准则。我们期望所有贡献者在交互中保持尊重和建设性。

📄 许可证

本项目采用 MIT许可证。

免责声明：这是Brad Stevens的个人项目。
它与Microsoft Corporation没有关联，也未得到其认可。