Datafocus

🚀 FOCUS DATA MCP 服务器

Model Context Protocol (MCP) 服务器让人工智能助手能够直接查询数据结果。用户可使用自然语言从 DataFocus 获取数据。

🚀 快速开始

Model Context Protocol (MCP) 服务器使人工智能助手能直接查询数据结果，用户可通过自然语言从 DataFocus 获取数据。

✨ 主要特性

• 在 DataFocus 上注册，开启应用空间，并导入（直接连接）待分析的数据表。
• 选择 Datafocus 数据表来初始化对话。
• 使用自然语言获取数据结果。

📦 安装指南

先决条件

• JDK 23 或更高版本。可下载 JDK
• Gradle 8.12 或更高版本。可下载 Gradle
• 在 Datafocus 注册以获取承载令牌：
  1. 在 Datafocus 注册一个账户。
  2. 创建一个应用。
  3. 进入该应用。
  4. 管理 -> 接口认证 -> 承载令牌 -> 新建承载令牌。

安装步骤

1. 克隆此仓库：

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

2. 构建服务器：

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": "test",
  "bearer": "ZTllYzAzZjM2YzA3NDA0ZGE3ZjguNDJhNDjNGU4NzkyYjY1OTY0YzUxYWU5NmU="
}

2. gptText2DataInit

初始化对话。 参数：

示例：

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

3. gptText2DataData

使用自然语言查询数据。 参数：

示例：

{
  "question": "显示所有员工的信息",
  "bearer": "ZTllYzAzZjM2YzA3NDA0ZGE3ZjguNDJhNDjNGU4NzkyYjY1OTY0YzUxYWU5NmU="
}

响应格式

所有 API 请求将返回以下统一的 JSON 格式：

{
  "code": 200,          // 状态码
  "message": "成功",    // 描述信息
  "data": {}            // 返回的数据
}

如果发生错误，响应将包含错误代码和消息。

💻 使用示例

Visual Studio Code

1. 配置 MCP 设置文件（如上所述）。
2. 在终端中运行服务器：

java -jar build/libs/focus_mcp_data.jar

3. 使用 MCP 工具进行交互。

示例对话

查询表格列表

{
  "method": "tableList",
  "params": {
    "bearer": "ZTllYzAzZjM2YzA3NDA0ZGE3ZjguNDJhNDjNGU4NzkyYjY1OTY0YzUxYWU5NmU="
  }
}

初始化对话

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

查询数据

{
  "method": "gptText2DataData",
  "params": {
    "question": "显示所有员工的信息",
    "bearer": "ZTllYzAzZjM2YzA3NDA0ZGE3ZjguNDJhNDjNGU4NzkyYjY1OTY0YzUxYWU5NmU="
  }
}

📞 联系方式

https://discord.gg/mFa3yeq9