Ce guide vous accompagne dans l'installation et la configuration initiale du serveur MCP MySQL.
- PHP >= 8.1
- MySQL/MariaDB >= 5.7
- Composer pour la gestion des dépendances
# Vérifiez que ces extensions sont installées
php -m | grep -E "(pdo|pdo_mysql|json|mbstring)"Si des extensions manquent :
# Ubuntu/Debian
sudo apt install php-pdo php-mysql php-json php-mbstring
# CentOS/RHEL
sudo yum install php-pdo php-mysqlnd php-json php-mbstring
# macOS avec Homebrew
brew install php-
Récupérer le serveur :
# Cloner ou copier le répertoire mysql/ cp -r /chemin/source/mysql /votre/projet/mcp-servers/mysql cd /votre/projet/mcp-servers/mysql
-
Installer les dépendances :
composer install
-
Rendre exécutable :
chmod +x server.php server-cli.php server-wrapper.php
Si vous voulez utiliser le même serveur pour plusieurs projets :
# Installation dans un répertoire central
mkdir -p ~/.local/mcp-servers
cp -r mysql ~/.local/mcp-servers/
cd ~/.local/mcp-servers/mysql
composer install
chmod +x *.phpCopiez le fichier d'exemple :
cp .env.example .envÉditez .env avec vos paramètres :
# Connexion MySQL
MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_USER=your_user
MYSQL_PASS=your_password
MYSQL_DB=your_database
# Permissions (à ajuster selon vos besoins)
ALLOW_INSERT_OPERATION=false
ALLOW_UPDATE_OPERATION=false
ALLOW_DELETE_OPERATION=falseTestez votre configuration :
php test_connection.phpVous devriez voir :
🔍 Test de connexion MySQL...
DSN: mysql:host=127.0.0.1;port=3306;dbname=your_database;charset=utf8mb4
✅ Connexion PDO réussie!
MySQL version: 8.0.x
Base de données courante: your_database
Testez le serveur complet :
php test_mcp_server.phpAjoutez dans votre fichier de configuration MCP (.cursor/mcp.json ou équivalent) :
{
"mcpServers": {
"mysql": {
"command": "php",
"args": ["/chemin/absolu/vers/mysql/server.php"]
}
}
}Pour surcharger la configuration par projet :
{
"mcpServers": {
"mysql": {
"command": "php",
"args": ["/chemin/absolu/vers/mysql/server.php"],
"env": {
"MYSQL_HOST": "127.0.0.1",
"MYSQL_PORT": "3306",
"MYSQL_USER": "project_user",
"MYSQL_PASS": "project_password",
"MYSQL_DB": "project_database"
}
}
}
}Pour tester le serveur avec des données d'exemple :
php setup_test_data.phpCela créera :
- users : 5 utilisateurs test
- orders : 9 commandes liées aux utilisateurs
- categories : 6 catégories avec hiérarchie
Une fois Claude Code configuré, testez :
Liste les bases de données disponibles
→ Devrait utiliser mysql_list_databases
Montre-moi la structure de la table users
→ Devrait utiliser mysql_describe_table
Consultez les logs d'erreur :
# Logs du serveur (STDERR)
tail -f /var/log/php_errors.log
# Ou lancez le serveur en mode debug
LOG_LEVEL=DEBUG php server.phpPour un environnement de production, commencez par :
# .env pour production
ALLOW_INSERT_OPERATION=false
ALLOW_UPDATE_OPERATION=false
ALLOW_DELETE_OPERATION=false
ALLOW_TRUNCATE_OPERATION=false
BLOCK_DANGEROUS_KEYWORDS=true
MAX_RESULTS=100
QUERY_TIMEOUT=10Créez un utilisateur MySQL spécifique :
-- Utilisateur en lecture seule
CREATE USER 'mcp_readonly'@'localhost' IDENTIFIED BY 'secure_password';
GRANT SELECT ON your_database.* TO 'mcp_readonly'@'localhost';
-- Utilisateur avec permissions limitées
CREATE USER 'mcp_limited'@'localhost' IDENTIFIED BY 'secure_password';
GRANT SELECT, INSERT, UPDATE ON your_database.* TO 'mcp_limited'@'localhost';
FLUSH PRIVILEGES;# Vérifiez que vous utilisez 127.0.0.1 au lieu de localhost
MYSQL_HOST=127.0.0.1# Vérifiez les identifiants MySQL
mysql -h 127.0.0.1 -P 3306 -u your_user -p your_database# Installez les extensions manquantes
sudo apt install php-pdo php-mysql# Test avec logs détaillés
LOG_LEVEL=DEBUG php server.phpAprès installation réussie :
mysql/
├── server.php ✅ Serveur principal
├── server-cli.php ✅ Serveur avec arguments CLI
├── server-wrapper.php ✅ Wrapper pour fichiers .env
├── .env ✅ Configuration locale
├── test_connection.php ✅ Test de connexion
├── test_mcp_server.php ✅ Test du serveur
├── setup_test_data.php ✅ Données de test
├── src/ ✅ Code source
├── vendor/ ✅ Dépendances
├── composer.json ✅ Configuration Composer
└── docs/ ✅ Documentation
Une fois l'installation terminée :
- Configuration avancée : Consultez Variables d'Environnement
- Sécurité : Lisez le guide Sécurité
- Usage : Voir Exemples d'Usage
- Multi-projets : Guide Configuration Multi-Projets
Si vous rencontrez des problèmes :
- Consultez Troubleshooting
- Vérifiez les logs avec
LOG_LEVEL=DEBUG - Testez la connexion MySQL directement
- Ouvrez une issue avec les détails de votre configuration
Installation terminée ? Passez au Premier Démarrage ! 🎉