Focus SQL

🚀 FOCUS データセット MCP サーバー [English]

モデルコンテキストプロトコル（MCP）サーバーは、人工知能アシスタントが自然言語を SQL 文に変換することを可能にします。

🚀 クイックスタート

モデルコンテキストプロトコル（MCP）サーバーは、自然言語を SQL 文に変換する機能を提供します。focus_mcp_sql は、LLM の幻覚を制御し、出力の規範性を保証する 2 段階の SQL 生成ソリューションを採用しています。

✨ 主な機能

なぜ別の Text-to-SQL フレームワークが必要なのか？

簡単に言えば、focus_mcp_sql は 2 段階の SQL 生成ソリューションを採用しており、LLM の幻覚を制御し、出力の規範性を保証します。他のフレームワークと比較して、機能と性能の面で明らかな優位性があります。

以下は、既存のフレームワークとの比較分析です。

機能概要

1. モデルの初期化：データセットのメタ情報（テーブル構造、フィールド属性、テーブル間の関連関係を含む）を提供することで、特定ドメインの言語モデルを初期化します。
2. 自然言語から SQL への変換：初期化されたモデルを基に、ユーザーが入力した自然言語のクエリを規範的な SQL 文に変換します。

📦 インストール

前提条件

1. インストール要件
   • オペレーティングシステム：Linux、Windows をサポート
   • メモリ要件：>=4GB
   • ディスク容量：>=10GB
2. 依存関係
   • Java 8+
   • Python 3.7+

インストール手順

1. コードリポジトリのダウンロード

git clone https://github.com/your-organization/focus-mcp.git
cd focus-mcp

2. 環境の設定

config.json ファイルを作成し、以下の内容を記述します。

{
  "model_path": "path/to/model",
  "data_source": "path/to/data"
}

3. サービスの起動

python server.py

📚 ドキュメント

MCP の設定

モデルの初期化（ツール: gpt_text2sql_init）

パラメータの説明：

• model_id：異なるデータセットのコンテキスト情報を区別するための一意の識別子
• schema：データテーブルの構造で、テーブル名、フィールド名、フィールドタイプを含みます
• properties：フィールドの属性で、主キー、外部キーなどの制約情報を含みます
• relations：テーブル間の関連関係で、関連タイプ（内部結合、外部結合）と関連条件を含みます

例：

{
  "model_id": "your-model-id",
  "schema": {
    "tables": [
      {
        "name": "employees",
        "columns": ["id", "name", "age"]
      },
      {
        "name": "departments",
        "columns": ["did", "dname"]
      }
    ]
  },
  "properties": {
    "id": { "primaryKey": true },
    "did": { "foreignKey": "employees.id" }
  },
  "relations": [
    {
      "type": "inner-join",
      "condition": "employees.did = departments.did"
    }
  ]
}

自然言語を SQL に変換（ツール: gpt_text2sql_chat）

パラメータの説明：

• chat_id：対話の一意の識別子
• query：ユーザーが入力した自然言語のクエリ
• context：コンテキスト情報で、初期化されたモデル ID と関連テーブルの情報を含みます

例：

{
  "chat_id": "your-chat-id",
  "query": "表示员工的最大年龄",
  "context": {
    "model_id": "your-model-id",
    "tables": ["employees"]
  }
}

応答形式

すべてのツールの返却結果は、以下の形式を採用しています。

{
  "errCode": 0,
  "exception": "",
  "msgParams": null,
  "promptMsg": null,
  "success": true,
  "data": {
    // 具体的な業務データ
  }
}

💻 使用例

VS Code の使用例

1. C++ 可視化デバッグツールをインストールします。
2. MCP サーバーを設定します。
3. 使用方法：
   • モデルを初期化します。
   • クエリを実行します：社員の最大年齢を表示します。

📄 ライセンス

ライセンス情報は提供されていません。

📞 連絡先

https://discord.gg/AVufPnpaad