Remote MCP Functions Dotnet

🚀 微軟雲平臺（Azure）MCP 服務器創建與交互指南

本指南將詳細介紹如何在微軟雲平臺（Azure）上使用函數（Functions）創建一個 MCP（Microsoft Cloud Platform）服務器，並通過 GitHub Copilot 進行交互，幫助開發者輕鬆部署和管理應用程序。

🚀 快速開始

準備工作

1. 註冊 Microsoft 帳戶：若還沒有 Microsoft 帳戶，需先註冊一個。
2. 安裝 Azure CLI：確保計算機上已安裝最新的 Azure CLI 工具，並完成配置。
3. 安裝 Visual Studio Code：作為主要開發工具，VS Code 是不錯的選擇，且支持多種插件增強功能。

✨ 主要特性

• 藉助 Azure 豐富的功能和工具，輕鬆部署和管理應用程序。
• 利用 Azure 函數創建 MCP 服務器，實現高效的服務器搭建。
• 通過 GitHub Copilot 進行交互，在編碼時獲得即時幫助。

📦 安裝指南

創建 Azure 函數應用

步驟 1：登錄到 Azure 賬戶

在終端或命令提示符中運行以下命令登錄到你的 Microsoft 帳戶：

az login

按照提示輸入憑據完成登錄。

步驟 2：創建資源組

為函數應用創建一個新的資源組，執行以下命令：

az group create --name myResourceGroup --location "East US"

此命令將在“美國東部”區域創建一個名為 myResourceGroup 的資源組。

步驟 3：創建函數應用

使用以下命令創建 Azure 函數應用：

az functionapp create \
    --name myFunctionApp \
    --resource-group myResourceGroup \
    --location "East US" \
    --runtime dotnet-isolated \
    --functions-version 4

該命令會創建一個名為 myFunctionApp 的函數應用，使用 .NET Isolated 運行時，並指定版本為 4。

配置 MCP 服務器

步驟 1：克隆示例代碼庫

克隆一個包含 MCP 服務器功能的示例代碼倉庫，可從 GitHub 找到合適項目或創建新項目：

git clone https://github.com/yourusername/mcp-function.git

步驟 2：安裝依賴項

進入項目目錄後，安裝所需的 NuGet 包和其他依賴項。對於 .NET 項目，使用 dotnet restore 恢復所有依賴項：

cd mcp-function
dotnet restore

部署到 Azure

步驟 1：構建函數應用包

構建函數應用包以便部署到 Azure：

dotnet build --configuration Release

此命令將生成一個名為 bin/Release/net6.0/isolated/runtimes/win-x64/publish 的發佈文件夾。

步驟 2：部署到 Azure 函數應用

使用以下命令將構建好的包部署到函數應用：

az functionapp deploy --name myFunctionApp --resource-group myResourceGroup --path .\bin\Release\net6.0\isolated\runtimes\win-x64\publish

配置 MCP 工具

步驟 1：定義 MCP 工具觸發器

在函數中，使用 [McpToolTrigger] 屬性定義工具的名稱和描述，例如：

[Function(nameof(SaveSnippet))]
[BlobOutput("snippets/{snippet}")]
public async Task<IActionResult> SaveSnippet(
    [McpToolTrigger("save-snippet", "Saves a snippet to storage")] ToolInvocationContext context,
    [McpToolProperty("snippet-name", "name of the snippet", "Name of the snippet")] string name,
    [McpToolProperty("snippet-content", "content of the snippet", "Content of the snippet")] string content)
{
    await blobService.SaveAsync(name, content);
    return new OkResult();
}

步驟 2：配置 MCP 工具屬性

在函數中，使用 [McpToolProperty] 屬性定義工具的輸入參數，例如：

[Function(nameof(GetSnippet))]
[BlobInput("snippets/{snippet}")]
public async Task<IActionResult> GetSnippet(
    [McpToolTrigger("get-snippet", "Retrieves a snippet from storage")] ToolInvocationContext context,
    [McpToolProperty("snippet-name", "name of the snippet", "Name of the snippet")] string name)
{
    var content = await blobService.GetAsync(name);
    return new ContentResult { Content = content };
}

配置 GitHub Copilot

步驟 1：安裝必要的 VS Code 插件

確保已安裝以下插件：

• VS Live Share：用於即時協作。
• Azure Functions：用於與 Azure 函數進行交互。

步驟 2：連接到 Azure 賬戶

在 VS Code 中，使用 Azure 的“Connect to Azure Account”命令登錄你的 Microsoft 帳戶。

步驟 3：配置 Copilot

在 VS Code 中，啟用 GitHub Copilot 並按提示進行設置。完成後，可在編碼時獲得即時幫助。

💻 使用示例

創建新工具

步驟 1：創建新函數

dotnet new functionapp -n MyMCPFunction --output .

步驟 2：添加 MCP 工具功能

編輯 MyMCPFunction/Functions/Program.cs 文件，添加所需功能，例如：

public class SaveSnippet : FunctionBase
{
    private readonly IBlobService blobService;

    public SaveSnippet(IBlobService blobService)
    {
        this.blobService = blobService;
    }

    [Function("save-snippet")]
    public async Task<IActionResult> Run(
        [McpToolTrigger] ToolInvocationContext context,
        [McpToolProperty("snippet-name", "name")] string name,
        [McpToolProperty("snippet-content", "content")] string content)
    {
        await blobService.SaveAsync(name, content);
        return new OkResult();
    }
}

使用工具

步驟 1：調用工具

在 VS Code 中，使用 GitHub Copilot 輸入以下命令調用 MCP 工具：

/invoke save-snippet --snippet-name "mysnippet" --snippet-content "This is my snippet content."

步驟 2：查看結果

確認工具是否成功執行，並在控制檯或日誌中查看輸出。

📚 詳細文檔

驗證和故障排除

檢查部署狀態

使用以下命令檢查函數應用的部署狀態：

az functionapp show --name myFunctionApp --resource-group myResourceGroup

查看日誌

若遇到問題，可查看函數的應用日誌進行調試：

az functionapp log tail --name myFunctionApp --resource-group myResourceGroup

驗證工具調用

通過調用 MCP 工具並檢查結果，確保其正常工作。

清理資源

完成所有操作後，建議清理不再需要的資源以避免不必要的費用，可使用以下命令刪除資源組：

az group delete --name myResourceGroup

通過以上步驟，你已成功創建並配置了一個 MCP 服務器，並通過 GitHub Copilot 進行了交互。