Mcponfunconaca

🚀 使用 Azure Functions（Python）的遠程 MCP 服務器

本項目可幫助你在 Azure Functions 上運行一個遠程 MCP 服務器，藉助 Azure Functions 和 Python，能輕鬆構建並部署自定義遠程 MCP 服務器到雲端，且 MCP 服務器通過實驗性功能支持，可作為工具提供給語言模型（LLM）。

🚀 快速開始

這是一個快速入門模板，用於輕鬆構建和部署自定義遠程 MCP 服務器到雲中使用 Azure Functions 和 Python。MCP 服務器通過實驗性功能支持，可以作為工具提供給語言模型（LLM）。MCP 功能需要在函數應用中啟用，並且可以在 host.json 中引用實驗性捆綁包。

{
  "extensions": {
    "httpExtension": {},
    "mcpExtension": {}
  },
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Experimental",
    "version": "[4.*, 5.0.0)"
  }
}

✨ 主要特性

• 藉助 Azure Functions 和 Python 構建並部署自定義遠程 MCP 服務器到雲端。
• MCP 服務器通過實驗性功能支持，可作為工具提供給語言模型（LLM）。

📦 安裝指南

必要條件

• 基本瞭解 Azure Functions 和 Python
• 安裝並配置了 Azure CLI
• 一個 Azure 賬戶和訂閱

創建函數應用

使用 azd 命令創建一個新的 Azure Functions 應用，並指定運行時為 Python：

azd init --name <your_function_app_name> --location <region> --runtime python

進入項目目錄並初始化 mcp.json 和其他必要文件：

cd . && azd up

💻 使用示例

基礎用法

配置 MCP 服務器

在 host.json 中啟用實驗性功能和 MCP 擴展：

{
  "extensions": {
    "httpExtension": {},
    "mcpExtension": {}
  },
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Experimental",
    "version": "[4.*, 5.0.0)"
  }
}

在 mcp.json 中定義 MCP 工具：

{
  "myMCPTool": {
    "type": "functionTrigger",
    "description": "Retrieve attractions at a search location.",
    "properties": {},
    "trigger": {
      "funcName": "get_attractions"
    }
  }
}

創建函數

在 src 目錄下創建一個 Python 函數文件（例如 function_app.py），並添加以下代碼：

import logging
import json

def get_attractions(context):
    """
    Retrieves attractions at a search location using the RapidAPI endpoint.

    Args:
        context: The trigger context containing the input arguments.

    Returns:
        str: A JSON string containing the attractions or an error message.
    """
    content = json.loads(context)
    query = content["arguments"].get("query", "").strip()
    language_code = content["arguments"].get("languagecode", "en-us").strip()

    # Add your logic to call RapidAPI here

    return json.dumps({
        "result": "Success",
        "message": f"Successfully retrieved attractions for {query}"
    })

def hello_mcp(context):
    """
    A simple function that returns a greeting message.

    Args:
        context: The trigger context (not used in this function).

    Returns:
        str: A greeting message.
    """
    return "Hello I am MCPTool!"

高級用法

部署到 Azure

使用 azd 命令將項目部署到 Azure：

azd up

這會創建所有必要的 Azure 資源，包括函數應用、存儲賬戶和 API 管理實例。

訪問 MCP 服務器

部署完成後，可以從 VS Code 或任何兼容的客戶端訪問 MCP 服務器。通過 mcp.json 配置工具，並使用以下 URL 訪問：

https://<your_function_app_name>.azurewebsites.net/runtime/webhooks/mcp/sse

📚 詳細文檔

注意事項

• 使用 API Management 提高安全性
• 啟用 內置身份驗證 以支持 OAuth 提供商
• 啟用 VNET 使用 VNET_ENABLED=true 標誌

下一步

• 在你的 MCP 服務器上添加 API 管理
• 在你的 MCP 服務器上啟用 內置身份驗證
• 啟用 VNET 使用 VNET_ENABLED=true 標誌
• 瞭解更多關於 Microsoft 的相關 MCP 努力