Focus Data MCP Server 使用说明

项目简介

Focus Data MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在连接AI助手和 DataFocus 数据分析平台。通过该服务，用户可以使用自然语言直接查询 DataFocus 中已导入的数据，从而实现更自然、便捷的数据访问和分析体验。

主要功能点

数据访问能力：允许AI助手通过MCP协议访问DataFocus平台的数据资源。
工具注册与执行：提供了 'tableList', 'gptText2DataInit', 'gptText2DataData' 等工具，支持获取表列表、初始化对话和执行自然语言数据查询。
自然语言数据查询：用户可以使用自然语言提问，服务器将解析并从DataFocus获取相应的数据结果。

安装步骤

克隆仓库

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

构建服务器
```
gradle clean
gradle bootJar
```
构建成功后，JAR 文件位于 'build/libs/focus_mcp_data.jar'。

服务器配置

要将 Focus Data MCP Server 集成到 MCP 客户端（例如 VS Code Cline 插件），您需要在客户端的 MCP 设置文件中添加服务器配置。以下是一个 '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"
      ]
    }
  }
}

配置参数说明:

'server name': 'focus_mcp_data' (服务器名称，在客户端中用于标识和引用)
'command': 'java' (启动服务器的命令，这里使用 Java 运行时环境)
'args': '["-jar", "path/to/focus_mcp_data/focus_mcp_data.jar"]' (命令参数，指定运行 JAR 文件。请将 'path/to/focus_mcp_data/focus_mcp_data.jar' 替换为 JAR 文件的实际路径)
'autoApprove': '["tableList", "gptText2DataInit", "gptText2DataData"]' (自动允许客户端调用的工具列表)

基本使用方法

确保已安装 JDK 23+ 和 Gradle 8.12+，并已注册 DataFocus 账号并获取 Bearer Token。
启动 Focus Data MCP Server。
在 MCP 客户端中配置并连接到 'focus_mcp_data' 服务器。
使用客户端提供的界面或命令，调用 'tableList' 工具获取 DataFocus 中的表列表。
使用 'gptText2DataInit' 工具初始化对话，选择需要查询的表。
使用 'gptText2DataData' 工具，通过自然语言输入查询语句，获取数据结果。具体工具的使用参数和示例请参考仓库 README.md 文件中 "Available Tools" 部分的说明。

关键词