README_CN.md

FOCUS DATA MCP Server [English]

模型上下文协议（MCP）服务器使人工智能助手能够直接查询数据结果。用户以自然语言获取datafocus中的数据结果。

特征

• 注册DataFocus开通应用空间，导入（直连）待分析数据表
• 选择Datafocus数据表初始化对话框
• 通过自然语言提问获取查询结果

准备

• jdk 23 或者以上版本。 下载jdk
• gradle 8.12 或者以上版本。 下载gradle
• 注册 Datafocus 账号获取 Bearer Token:
  1. 进入 Datafocus 官网注册账号
  2. 创建一个应用
  3. 进入应用
  4. 系统配置 -> 接口鉴权 -> 承载令牌 -> 新增承载令牌

安装

1. Clone this repository:

git clone https://github.com/FocusSearch/focus_mcp_data.git
cd focus_mcp_data

2. Build the server:

gradle clean
gradle bootJar

生成的 jar 包路径: build/libs/focus_mcp_data.jar

MCP 配置文件

添加一下配置到 MCP 的配置文件 (通常在以下目录 ~/AppData/Roaming/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "focus_mcp_data": {
      "command": "java",
      "args": [
        "-jar",
        "path/to/focus_mcp_data/focus_mcp_data.jar"
      ],
      "autoApprove": [
        "tableList",
        "gptText2DataInit",
        "gptText2DataData"
      ]
    }
  }
}

可用的工具列表

1. tableList

获取 Datafocus 的表列表.

参数:

• name (可选): 需要查找的表名
• bearer (必须): bearer token

样例:

{
  "name": "test",
  "bearer": "ZTllYzAzZjM2YzA3NDA0ZGE3ZjguNDJhNDjNGU4NzkyYjY1OTY0YzUxYWU5NmU="
}

2. gptText2DataInit

初始化对话.

参数:

• names (必须): 选择的表名列表
• bearer (必须): bearer token
• language (可选): 语言 ['english','chinese']

样例:

{
  "names": [
    "test1",
    "test2"
  ],
  "bearer": "ZTllYzAzZjM2YzA3NDA0ZGE3ZjguNDJhNDjNGU4NzkyYjY1OTY0YzUxYWU5NmU="
}

3. gptText2DataData

对话获取查询结果.

参数:

• chatId (必须): 初始化对话的对话id
• input (必须): 需要查询的自然语言
• bearer (必须): bearer token

样例:

{
  "chatId": "03975af5de4b4562938a985403f206d4",
  "input": "max(age)",
  "bearer": "ZTllYzAzZjM2YzA3NDA0ZGE3ZjguNDJhNDjNGU4NzkyYjY1OTY0YzUxYWU5NmU="
}

响应结构

工具返回的数据结构如下:

{
  "errCode": 0,
  "exception": "",
  "msgParams": null,
  "promptMsg": null,
  "success": true,
  "data": {
  }
}

Visual Studio Code Cline 示例

1. vsCode 安装cline插件
2. 配置 mcp server
3. 使用
   1. 获取表列表
   2. 初始化
   3. 查询数据：销售金额的总和是多少

其他问题联系：