跳轉到

MCP 服務 / MCP 程式設計

於 7.6.0 版本新增

「MCP 程式設計」是 DataFlux Func 的一個用於支援 AI Agent 在 Func 中編寫、管理指令碼的功能。

使用者可以透過 MCP 服務的方式,允許 AI Agent 參與 DataFlux Func 中函式的編寫和管理。

1. 接入步驟

可以按照如下步驟,將 MCP 客戶端 / AI Agent 接入 DataFlux Func 的 MCP Coding 服務

1.1 建立 Access Token

訪問 DataFlux Func 的 MCP Coding 服務需要建立 Access Token,並開啟「MCP 程式設計」功能

並可以在規則中指定所需開放函式(如:按指令碼集 ID)

add-access-token.png

add-access-token-2.png

1.2 許可權規則

許可權規則可以手工編輯,從上到下依次匹配,按照首個命中的規則確定許可權。

示例如下:

規則(精確匹配 ID) 匹配物件 匹配 ID 許可權
scriptSet:mytest:r 指令碼集 mytest 讀取
scriptSet:mytest:rw 指令碼集 mytest 讀取、修改
scriptSet:mytest:rwx 指令碼集 mytest 讀取、修改、執行
scriptSet:mytest:rwxp 指令碼集 mytest 讀取、修改、執行、釋出
script:mytest__demo:r 指令碼 mytest__demo 讀取
規則(通配 ID) 匹配物件 通配 ID 許可權
scriptSet:my*:r 指令碼集 my* 通配 讀取
script:mytest__de*:r 指令碼 mytest__de* 通配 讀取

1.3 配置 MCP 客戶端

DataFlux Func 的 MCP 服務遵循 MCP 規範

在實際對接前,推薦使用 MCP Inspector 進行除錯

在 MCP 客戶端 / AI Agent 中新增如下配置:

配置項
URL 地址 {DataFlux Func 訪問地址}/mcp/coding
請求頭 X-Dff-Access-Token: atk-xxxxx:xxxxx
示例:OpenCode 配置
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "mcp": {
    "dataflux-func-mcp-coding": {
      "enabled": true,
      "type"   : "remote",
      "url"    : "{DataFlux Func 訪問地址}/mcp/coding",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}

1.4 初始化本地協作說明

最新版 MCP Coding 服務的 help 工具已經包含推薦的本地 AGENTS.md 協作說明,不需要使用者手工建立。

接入後,建議讓 AI Agent 先呼叫 MCP 服務 dataflux-func-testinghelp 工具,並根據返回的建議進行初始化。

2. 實際操作示例

MCP Coding 中已經內建了大量面向 Func 開發的提示詞和工具說明。輸入提示詞時,可以直接以「AI Agent 已經充分了解 Func 的最佳使用方式」為前提描述目標。

例如:

  • 根據 MCP 服務 dataflux-func-testing 建議進行初始化
  • 同步指令碼集 demo 的所有程式碼

首先請先確認 AI Agent 是否成功連線到 DataFlux Func 的 MCP Coding 服務:

opencode-mcp-status.png

之後,正常輸入提示詞即可

opencode-process.png

opencode-process-2.png

AI Agent 完成後,在 DataFlux Func 中重新整理即可看到 AI 編寫的程式碼

code.png