mysql-materials-mcp
Allows querying a MySQL database of metallurgical material specifications (alloys, grades, chemical elements, standards, mechanical properties) via read-only tools.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mysql-materials-mcp list all alloy types"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Base de données Matériaux & Alliages
Projet personnel autour d'une base de données de fiches techniques métallurgiques (alliages, nuances, éléments chimiques, normes, propriétés mécaniques). L'ensemble explore la modélisation relationnelle (MySQL) et son exposition via trois points d'accès distincts. Projet local, à visée exploratoire et technique.
Le projet se compose de trois dépôts complémentaires :
mysql-materials-server — Back-end Node.js / MySQL. Gère la base de données et expose une API REST (CRUD).
mysql-materials-front — Front React / React Admin. Interface d'administration CRUD des fiches techniques.
mysql-materials-mcp — Serveur MCP (Node.js). Expose l'accès à la base pour interrogation via un LLM.
mysql-materials-mcp
Serveur MCP (Model Context Protocol) qui expose la base MySQL du projet à un LLM (Claude Desktop). Claude peut ainsi interroger la base en langage naturel : lister les types d'alliage, filtrer les nuances par type, et récupérer le détail complet d'une nuance avec toutes ses relations.
Le serveur communique avec Claude Desktop via stdio (pas d'API HTTP, pas de port réseau). Il est actuellement en lecture seule.
Related MCP server: MySQL MCP Server
Stack technique
Node.js (ESM,
"type": "module")@modelcontextprotocol/sdk — SDK officiel MCP
mysql2 — accès à la base MySQL (pool de connexions)
zod — validation des paramètres des tools
Prérequis
Node.js (version récente recommandée)
Claude Desktop installé
La base MySQL
materials_dbdoit exister et être accessible. Elle est créée et alimentée par le dépôtmysql-materials-server(voir son README) ; ce serveur MCP ne fait que la lire.
Installation
npm installConfiguration
Contrairement à un projet Node classique, un serveur MCP est lancé comme sous-processus par Claude Desktop, depuis un répertoire de travail qui n'est pas celui du projet. Un fichier .env local ne serait donc pas trouvé de façon fiable. Les variables d'environnement sont donc injectées directement par Claude Desktop, via le bloc env de sa configuration.
Un modèle est fourni : claude_desktop_config.example.json.
Il faut reporter son contenu dans le fichier de configuration de Claude Desktop, situé à :
Windows :
%APPDATA%\Claude\claude_desktop_config.jsonmacOS :
~/Library/Application Support/Claude/claude_desktop_config.json
Exemple de configuration à adapter :
{
"mcpServers": {
"mysql-materials-mcp": {
"command": "node",
"args": ["CHEMIN_ABSOLU/mysql-materials-mcp/server.js"],
"env": {
"DB_HOST": "localhost",
"DB_PORT": "...",
"DB_USER": "USER_READ_ONLY",
"DB_PASSWORD": "...",
"DB_NAME": "materials_db"
}
}
}
}Points importants :
args: chemin absolu versserver.js. Sous Windows, doubler les backslashes (C:\\...).Après toute modification, redémarrer complètement Claude Desktop (le quitter réellement, pas seulement fermer la fenêtre) pour qu'il relance le serveur avec les nouvelles variables.
Le fichier
claude_desktop_config.jsoncontient les identifiants en clair : il vit hors du dépôt et ne doit jamais être committé. Seul le modèleclaude_desktop_config.example.json(valeurs factices) est versionné.
Utilisateur MySQL en lecture seule (recommandé)
Le serveur étant en lecture seule, il est recommandé de lui dédier un utilisateur MySQL avec le seul droit SELECT.
Lancement
Le serveur est lancé automatiquement par Claude Desktop dès que celui-ci démarre (via la configuration ci-dessus). Une fois Claude Desktop redémarré, les trois tools apparaissent et sont utilisables dans une conversation.
Pour un test manuel en dehors de Claude Desktop :
npm start
# ou en développement avec rechargement auto :
npm run devStructure du projet
.
├── server.js # Point d'entrée MCP : création du serveur, enregistrement des tools, transport stdio
├── db/
│ └── configDb.js # Pool de connexions MySQL (lecture seule)
├── tools/ # Un fichier par tool exposé à Claude
│ ├── getAlloyTypes.tool.js # Liste des types d'alliage
│ ├── getAlloyNuances.tool.js # Nuances filtrées par type d'alliage
│ └── getAlloyNuanceById.tool.js # Détail complet d'une nuance
└── claude_desktop_config.example.json # Modèle de configuration Claude DesktopTools exposés
Le serveur expose trois tools, pensés pour une navigation progressive : d'abord les types, puis les nuances d'un type, puis le détail d'une nuance.
Tool | Paramètre | Rôle |
| aucun | Liste tous les types d'alliage (id, nom, description). |
|
| Liste les nuances (id, nom, description) d'un type donné. |
|
| Détail complet d'une nuance : type, mesures, composition chimique, états métallurgiques, usages, normes. |
Le tool de détail effectue des JOIN pour renvoyer des noms lisibles (ex. « Carbon ») plutôt que des ids bruts, afin que le LLM exploite directement les données.
Les paramètres sont validés par Zod : Claude doit fournir le bon type (un nombre pour un id), sinon l'appel est rejeté avant d'atteindre la base.
Choix techniques
ESM : le SDK MCP est distribué en ESM, donc tout le projet est en
import/export("type": "module"danspackage.json).console.erroret jamaisconsole.log: sur le transport stdio, la sortie standard (stdout) est réservée au protocole MCP. Tout message de log doit passer parstderr, sinon il corromprait la communication avec Claude Desktop.Pool à faible limite (
connectionLimit: 3) : un MCP branché sur Claude Desktop dessert un seul utilisateur, pas du trafic web.multipleStatements: false: une seule requête par appel, plus sûr pour un serveur exposé à un LLM.Requêtes préparées (
?+ paramètres) : protection contre les injections SQL.
Sécurité
Lecture seule : le serveur n'expose que des
SELECT. Un utilisateur MySQL dédié avec le seul droitSELECTest recommandé pour garantir cette limite au niveau de la base.Identifiants hors du dépôt : ils vivent dans la configuration locale de Claude Desktop, jamais dans le code ni dans un fichier versionné.
Un serveur MCP tourne comme un sous-processus avec les droits de l'utilisateur : n'exposer que le strict nécessaire.
Limites connues / pistes d'amélioration
Lecture seule uniquement ; l'écriture via MCP est une piste en cours d'exploration.
Trois tools de consultation ; d'autres pourraient être ajoutés (recherche par nom, filtres croisés, etc.).
Projet local uniquement, non déployé.
Available Tools
3 toolsget_alloy_nuance_by_idA
Récupère le détail complet d'une nuance d'alliage par son id (composition, mesures, états, usages, normes)
Inputs: id (required).
get_alloy_nuancesB
Récupère la liste des nuances d'alliage (id, nom, description) pour un type d'alliage donné
Inputs: id_alloy_type (required).
get_alloy_typesA
Récupère tous les types d'alliage avec leur description.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct resource: alloy types, list of nuances for a type, and detailed nuance by ID. No overlap in purpose.
All tools use consistent 'get_' prefix followed by noun phrases in snake_case, e.g., get_alloy_types, get_alloy_nuances, get_alloy_nuance_by_id.
Three tools is on the low end but still acceptable for a focused read-only query server. The count is appropriate for the narrow scope.
The tool set covers read-only browsing of alloy types and nuances, but lacks write operations (create, update, delete) and more advanced queries. Notable gaps exist.
Maintenance
Related MCP Connectors
Trade-verified steel grade properties, substitution verdicts, and mill-cert guidance for AI agents.
Query, explore, and manage your databases through natural conversation.
PostgreSQL, MySQL, and SQL Server in one session. 26 read-only MCP tools for AI agents.
Ask questions in plain language, get answers from your business database. No SQL required.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables interaction with MySQL databases (including AWS RDS and cloud instances) through natural language. Supports database connections, query execution, schema inspection, and comprehensive database management operations.819 npm7MIT
- AlicenseNot gradedqualityDmaintenanceEnables natural language database operations on MySQL databases with AI integration, supporting CRUD operations, schema inspection, and audit logging with built-in security features including SQL injection protection and permission controls.MIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive MySQL database management including CRUD operations, schema queries, and natural language to SQL conversion support through complete database structure analysis.716 npm2MIT
- FlicenseNot gradedqualityDmaintenanceEnables management and querying of multiple MySQL databases through natural language, allowing AI assistants to list databases, execute SQL queries, and explore database schemas.1-