MCP 服务 / 访问函数

于 7.5.0 版本新增

MCP 服务是 DataFlux Func 的一个用于支持 AI Agent 工具调用的功能。

用户可以通过 MCP 服务的方式，向 AI Agent 提供 DataFlux Func 中的部分函数

1. 接入步骤

可以按照如下步骤，将 MCP 客户端 / AI Agent 接入 DataFlux Func 的 MCP 服务

1.1 创建 Access Token

访问 DataFlux Func 的 MCP 服务需要创建 Access Token，并开启「MCP 函数」功能

并可以在规则中指定所需开放函数的 category

1.2 配置 MCP 客户端

DataFlux Func 的 MCP 服务遵循 MCP 规范

在实际对接前，推荐使用 MCP Inspector 进行调试

在 MCP 客户端 / AI Agent 中添加如下配置：

配置项	值
URL 地址	{DataFlux Func 访问地址}/mcp 或 /mcp2、/mcp3 具体区别见下文「MCP 服务模式」
请求头	Authorization: Bearer atk-xxxxx:xxxxx

{
  "mcp": {
    "dataflux-func-mcp": {
      "enabled": true,
      "type"   : "remote",
      "url"    : "{DataFlux Func 访问地址}/mcp",
      "headers": {
        "Authorization": "Bearer atk-xxxxx:xxxxx"
      }
    },
  }
}

2. MCP 服务模式

DataFlux Func 的 MCP 服务根据接入路径不同，支持 3 种模式：

路径	模式
/mcp	基础模式
/mcp2	List-Call 模式
/mcp3	Search-Call 模式（推荐）

假设 Access Token 配置如下，且代码库中存在如下函数：

!category:test
category:math

2.1 /mcp 基础模式

直接将所有可用函数作为 Tool 列出

注意：当函数列表改变时，需要客户端重连才能更新列表

2.2 /mcp2 List-Call 模式

仅提供两个 Tool：

• list-func：列出函数
• call-func：调用函数

可以实现动态函数列表，需要 AI Agent / 模型能够正常遵循 List-Call 方式进行调用

2.3 /mcp3 Search-Call 模式

仅提供两个 Tool：

• search-func：查询函数
• call-func：调用函数

可以实现根据关键字查询所需函数，需要 AI Agent / 模型能够正常遵循 Search-Call 方式进行调用

在函数数量较多时，可大幅减少上下文长度