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沒有關聯，也未得到其認可。