MySQL Natural Language Agent

Ce qu'il fait

AgenteMySQL fait le pont entre les questions en langage courant et les bases de données MySQL/MariaDB. Propulsé par Ollama exécutant le modèle Gemma 3 localement, il traduit les prompts en langage naturel en requêtes SQL valides et les exécute sur votre base de données — gardant toutes les données et l'inférence entièrement sur site.

Outils

• natural_query — Accepte une question en texte libre et renvoie le SQL généré ainsi que les résultats de la requête de votre base de données MySQL/MariaDB.
• get_schema — Lit le schéma actuel de la base de données pour que le modèle puisse générer des requêtes précises et conscientes du contexte.

Installation

Clonez le repo et configurez un fichier .env avec vos identifiants de base de données :

git clone https://github.com/MartinMedinaRuvian/agentemysql
cd agentemysql
npm install

Créez le fichier .env :

DB_HOST=localhost
DB_USER=votre_utilisateur
DB_PASSWORD=votre_mot_de_passe
DB_NAME=votre_base_de_données

Démarrez dans l'ordre en utilisant les scripts .bat fournis (Windows) ou lancez les services Node directement :

1. node mcp/index.js — serveur MCP
2. node api/server.js — API REST
3. Assurez-vous que Ollama est lancé avec ollama run gemma3:12b
4. node api/server_agente.js — API Agent

Ouvrez index.html dans un navigateur pour interagir.

{
  "mcpServers": {
    "agentemysql": {
      "command": "node",
      "args": ["mcp/index.js"],
      "cwd": "/chemin/vers/agentemysql"
    }
  }
}

Hôtes supportés

Aucun client MCP spécifique confirmé dans le README. Fonctionne avec tout hôte MCP compatible stdio.