Function Compute：MCP Tool Hook

工作原理

MCP Tool Hook 基於 AgentRun MCP 代理層運行。代理層位於 MCP 用戶端（智能體）和 MCP 服務端之間，作為透明中介層轉寄所有 MCP 協議請求。啟用代理後，工具調用請求不再直接到達 MCP 服務，而是經過代理層中轉。代理層在執行 tools/list 和 tools/call 操作的前後，觸發已配置的 Hook 事件，將請求或響應轉寄至外部 Hook 服務（HTTP Webhook）進行處理。

以 POST_CALL_TOOL 事件為例，資料流轉過程如下：

1. 智能體發起工具調用請求。

2. AgentRun MCP 代理層接收請求，調用 MCP 服務執行工具操作。

3. MCP 服務返回原始結果。

4. 代理層根據 Hook 配置，將結果通過 HTTP POST 轉寄至 Hook 服務。

5. Hook 服務對結果進行處理（如脫敏、審計標記），返回修改後的結果。

6. 代理層將最終結果返回給智能體。

其他事件的流轉方式類似：PRE_CALL_TOOL 在工具調用前觸發，可修改請求參數或攔截調用；PRE_LIST_TOOLS 和 POST_LIST_TOOLS 分別在擷取工具列表前後觸發，可對工具列表進行預先處理或過濾修改。

部署模式

AgentRun 支援兩種 MCP Tool Hook 部署模式：

兩種模式使用相同的 Hook 配置方式，區別在於 MCP 服務的部署和引用方式。

準備工作

• 已開通 AgentRun 服務。可通過AgentRun 控制台確認。

• 已開通Function Compute（FC）服務，用於部署 MCP 服務和 Hook 服務。

• 已安裝 Golang 1.23 及以上開發環境。

• 已擷取阿里雲帳號的 UID、AccessKey ID 和 AccessKey Secret。擷取方式請參見擷取 AccessKey。

• 已準備 MCP 服務代碼和 Hook 服務代碼。完整樣本可從 start-agentrun 倉庫擷取：

  git clone https://github.com/devsapp/start-agentrun.git
  cd start-agentrun

  專案中包含兩個樣本目錄：mcp_remote（遠程 MCP 模式）和 mcp_code（代碼打包模式），分別對應兩種部署模式的完整樣本。以下操作步驟中的相對路徑均基於專案根目錄 start-agentrun/。

部署Function Compute服務時，預設使用國際站地區（如 ap-southeast-1）。請根據實際業務需求選擇合適的地區。

配置 MCP Tool Hook（mcp_remote 模式）

以下以訂單查詢服務（orderdesk）和資料脫敏 Hook 服務（userhook）為例，示範 mcp_remote 模式的完整配置流程。

go run .

{
  "order_id": "ORDER-1001",
  "customer_name": "張三",
  "phone": "138****5678",
  "email": "zhangsan@example.com",
  "shipping_address": "浙江省杭州市西湖區文三路 100 號",
  "status": "PAID",
  "amount": 259.8,
  "items": [
    {"sku": "SKU-AX100", "name": "人體工學滑鼠", "quantity": 1, "price": 129.9},
    {"sku": "SKU-KB200", "name": "機械鍵盤鍵帽", "quantity": 1, "price": 129.9}
  ]
}

{
  "order_id": "ORDER-1001",
  "customer_name": "張*",
  "phone": "138****5678",
  "email": "zh***@example.com",
  "shipping_address": "浙江省杭州市****",
  "status": "PAID",
  "amount": 259.8,
  "items": [
    {"sku": "SKU-AX100", "name": "人體工學滑鼠", "quantity": 1, "price": 129.9},
    {"sku": "SKU-KB200", "name": "機械鍵盤鍵帽", "quantity": 1, "price": 129.9}
  ],
  "audit_id": "audit_xxxxxxxxxxxxxxxx"
}

{
  "proxyEnabled": true,
  "hooks": [
    {
      "event": "POST_CALL_TOOL",
      "endpoint": "<Hook 服務的 Endpoint 地址>"
    }
  ]
}

配置 MCP Tool Hook（mcp_code 模式）

mcp_code 模式將 MCP 服務代碼打包到 AgentRun 運行時中，無需單獨部署 MCP 服務，簡化部署流程。以下同樣以 orderdesk（MCP 服務）和 userhook（Hook 服務）為例。

go run .

樣本：訂單資料脫敏 Hook 服務

樣本程式中的 Hook 服務（userhook）使用 Go 實現，處理 POST_CALL_TOOL 事件。以下是核心脫敏函數，完整代碼參見 start-agentrun 倉庫。

// maskPhone 對手機號進行掩碼處理，保留前 3 位和後 4 位。
func maskPhone(phone string) string {
    runes := []rune(strings.TrimSpace(phone))
    if len(runes) <= 7 {
        return "***"
    }
    return string(runes[:3]) + "****" + string(runes[len(runes)-4:])
}

// maskEmail 對郵箱進行掩碼處理，保留前 2 位使用者名稱。
func maskEmail(email string) string {
    parts := strings.SplitN(email, "@", 2)
    if len(parts) != 2 {
        return "***"
    }
    name := []rune(parts[0])
    keep := 1
    if len(name) > 2 {
        keep = 2
    }
    return string(name[:keep]) + "***@" + parts[1]
}

// maskAddress 對地址進行掩碼處理，保留前 6 個字元。
func maskAddress(address string) string {
    runes := []rune(strings.TrimSpace(address))
    if len(runes) <= 6 {
        return "***"
    }
    return string(runes[:6]) + "****"
}

// maskName 對姓名進行掩碼處理，保留姓氏。
func maskName(name string) string {
    runes := []rune(strings.TrimSpace(name))
    if len(runes) == 0 {
        return "***"
    }
    return string(runes[:1]) + "*"
}

// auditIDFromBytes 根據原始響應產生審計編號（SHA256 雜湊首碼）。
func auditIDFromBytes(body []byte) string {
    sum := sha256.Sum256(body)
    return "audit_" + hex.EncodeToString(sum[:])[:16]
}

Hook 服務接收代理層通過 HTTP POST 轉寄的事件裝載，負載中的請求和響應 Body 採用 Base 64 編碼。Hook 服務解碼後對敏感欄位進行掩碼處理，注入審計標識，再將修改後的結果 Base 64 編碼返回。

錯誤處理

Hook 服務異常時，代理層將中斷本次 MCP 請求：

常見問題