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