Servidor MCP de FOCUS DATA [中文]

Name: focus_mcp_sql
Author: FocusSearch

Un servidor de Protocolo de Contexto de Modelo (MCP) permite que los asistentes de inteligencia artificial conviertan el lenguaje natural en declaraciones SQL.

Ya existen muchos frameworks de conversión de texto a SQL. ¿Por qué necesitamos uno más?

En términos simples, focus_mcp_sql adopta una solución de generación de SQL de dos pasos, que permite controlar las alucinaciones de LLM y realmente genera la confianza de los usuarios no técnicos en los resultados de SQL generados.

A continuación se muestra la tabla de comparación entre focus_mcp_sql y otros:

Tabla de análisis comparativo

A continuación se muestra una comparación lado a lado de focus_mcp_sql con otros marcos basados en LLM:

Característica	Marcos tradicionales de LLM	enfoque_mcp_sql
Proceso de generación	Caja negra, generación directa de SQL	Transparente, dos pasos (palabras clave + SQL)
Riesgo de alucinaciones	Alto, depende de la calidad del modelo.	Bajo, controlable (verificación de palabras clave)
Velocidad	Lento, depende de la inferencia de modelos grandes	Conversión rápida y determinista de palabras clave a SQL
Costo	Alto, requiere modelos avanzados	Bajo, reduce la dependencia de modelos grandes
Facilidad de uso no técnico	Resultados bajos y difíciles de verificar	Comprobación de palabras clave fácil y de alta calidad

Características

-Inicializar el modelo -Convertir lenguaje natural a sentencias SQL

Related MCP server: X Tools for Claude MCP

Prerrequisitos

jdk 23 o superior. Descargar jdk
Gradle 8.12 o superior. Descargar Gradle.
Registre Datafocus para obtener el token portador:
1. Registrar una cuenta en Datafocus
2. Crear una aplicación
3. Ingresar a la aplicación
4. Administrador -> Autenticación de interfaz -> Token de portador -> Nuevo token de portador

Instalación

Clonar este repositorio:

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

Construir el servidor:

gradle clean gradle bootJar The jar path: build/libs/focus_mcp_sql.jar

Configuración de MCP

Agregue el servidor a su archivo de configuración MCP:

{ "mcpServers": { "focus_mcp_data": { "command": "java", "args": [ "-jar", "path/to/focus_mcp_sql/focus_mcp_sql.jar" ], "autoApprove": [ "gptText2sqlStart", "gptText2sqlChat" ] } } }

Herramientas disponibles

1. gptText2sqlStart

modelo inicial.

Parámetros:

model (obligatorio): modelo de tabla
bearer (obligatorio): token de portador
language (opcional): idioma ['inglés','chino']

Ejemplo:

{ "model": { "tables": [ { "columns": [ { "columnDisplayName": "name", "dataType": "string", "aggregation": "", "columnName": "name" }, { "columnDisplayName": "address", "dataType": "string", "aggregation": "", "columnName": "address" }, { "columnDisplayName": "age", "dataType": "int", "aggregation": "SUM", "columnName": "age" }, { "columnDisplayName": "date", "dataType": "timestamp", "aggregation": "", "columnName": "date" } ], "tableDisplayName": "test", "tableName": "test" } ], "relations": [ ], "type": "mysql", "version": "8.0" }, "bearer": "ZTllYzAzZjM2YzA3NDA0ZGE3ZjguNDJhNDjNGU4NzkyYjY1OTY0YzUxYWU5NmU=" }

modelo 参数说明：

名称	Persona que practica	类型	必选	Hablar
modelo	cuerpo	objeto	Yo	ninguno
" tipo	cuerpo	cadena	Yo	Los niños juegan en el patio trasero
" versión	cuerpo	cadena	Yo	Películas de terror de la película
» mesas	cuerpo	[objeto]	Yo	El hombre que se despierta
»» nombreParaMostrartabla	cuerpo	cadena	Sueño	El hombre que se despierta
»» nombreDeTabla	cuerpo	cadena	Sueño	El hombre que lleva el pelo
»» columnas	cuerpo	[objeto]	Sueño	El hombre que se despierta
»»» nombreParaMostrarcolumna	cuerpo	cadena	Yo	El hombre que se despierta
»»» nombreDeColumna	cuerpo	cadena	Yo	El hombre que lleva el pelo
»»» tipo de datos	cuerpo	cadena	Yo	El hombre que practicaba yoga
»»» agregación	cuerpo	cadena	Yo	El hombre que se despierta
» relaciones	cuerpo	[objeto]	Yo	El personal de limpieza de la casa
"" condiciones	cuerpo	[objeto]	Sueño	El hombre que se despierta
»»» NombreColdst	cuerpo	cadena	Sueño	dimensión 表关联列原始名
»»» srcColName	cuerpo	cadena	Sueño	hecho 表关联列原始名
»» tabla de dimensiones	cuerpo	cadena	Sueño	dimensión 表原始名
»» Tabla de hechos	cuerpo	cadena	Sueño	hecho 表原始名
»» Tipo de unión	cuerpo	cadena	Sueño	Los niños aprenden

2. gptText2sqlChat

Convertir lenguaje natural a SQL.

Parámetros:

chatId (obligatorio): ID del chat
input (obligatoria): lenguaje natural
bearer (obligatorio): token de portador

Ejemplo:

{ "chatId": "03975af5de4b4562938a985403f206d4", "input": "what is the max age", "bearer": "ZTllYzAzZjM2YzA3NDA0ZGE3ZjguNDJhNDjNGU4NzkyYjY1OTY0YzUxYWU5NmU=" }