Yapay zekânın bilgisayarınızdaki araçlara güvenli şekilde ulaşabilmesi için MCP adı verilen bir bağlantı kullanılır. Bu yapı veritabanı işlemlerini doğal dil ile yönetmek isteyen kullanıcılar için büyük kolaylık sağlar.
MySQL için MCP Veritabanı Sunucusunu beraber kuralım, ardından Claude Desktop ile bağlantısını kurarak tüm sistemi çalışır hâle getirelim.
Kuruluma Başlamadan Önce Gerekenler
Node.js ve MySQL, MCP sunucusunun çalışması için gerekli temel bileşenlerdir. Node.js’in 18 ve üzeri, MySQL’in ise 5.7 ya da 8.0 versiyonunda olması gereklidir. Daha eski sürümler, bağlantıda uyumsuzluk oluşturabilir.
Node.js kurulumuna geçmeden önce farklı platformlardaki Node.js yapılandırmalarını incelemek isterseniz “Plesk Server Üzerinde Node.js Nasıl Etkinleştirilir?” rehberimize göz atalabilirsiniz.
Node,js kurulumu için aşağıdaki komutu kullanabiliriz.
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs
MCP Veritabanı Sunucusunu Yükleyelim
MCP’nin çalışması için önce modelin sorgulayacağı kayıtları barındıran bir MySQL veritabanı oluşturulmalıdır. Güvenlik için MCP’ye özel bir MySQL kullanıcısı oluşturup yalnızca gerekli tablolara yetki vermek yeterlidir. Hızlı kurulum için npm’i, geliştirme yapmak için ise kaynak koddan derlemeyi tercih edebiliriz.
Önce MySQL’e giriş yapalım
mysql -u root -p
Ardından MCP için özel bir veritabanı oluşturalım
CREATE DATABASE mcpdb;
Bağlantıda kullanılacak kullanıcıyı tanımlayalım
CREATE USER 'mcp_user'@'%' IDENTIFIED BY 'GüçlüBirParola!123';
Bu kullanıcıya gerekli izinleri verelim
GRANT ALL PRIVILEGES ON mcpdb.* TO 'mcp_user'@'%';
FLUSH PRIVILEGES;
Veritabanı hazırlık işlemi tamamlandığında MCP artık bağlanmaya hazır hale gelir. Kurumsal yapılarda genellikle bu kullanıcıya sadece SELECT izni verilir, böylece veri bütünlüğü daha iyi korunur.
npm İle Kurulumu Tamamlayalım
Terminali açalım ve paketi sistemimize ekleyelim
npm install -g @executeautomation/database-server
Bu işlemin ardından sunucuyu komut satırından çağırabileceğimiz hâle getirelim. Böylece sonraki adımlara daha hızlı geçelim.
Kaynak Koddan Kurulum
Geliştirme veya özelleştirme düşünüyorsak depo klonlayalım.
git clone https://github.com/executeautomation/mcp-database-server.git cd mcp-database-server
Bağımlılıkları yükleyelim
npm install
Şimdi projeyi derleyelim
npm run build
Derleme tamamlandığında sunucuyu dist/src/index.js üzerinden çalıştırmaya hazır hâle getirelim.
MySQL ile MCP Sunucusunu Çalıştıralım
Kurulum hazır olduğuna göre MySQL’e bağlanacağımız komutu çalıştıralım. Yerel bir MySQL sunucusu kullanıyorsak aşağıdaki komutu terminalde çalıştıralım.
node dist/src/index.js --mysql --host 127.0.0.1 --database mysql --port 3306 --user root --password SifreBura
Claude Desktop Üzerinde MCP Sunucusu
Claude Desktop, MCP protokolünü yerel araç olarak destekleyen ilk uygulamalardan biridir. Bu özellik sayesinde Claude, doğrudan MySQL veritabanına bağlanabilir ve sorguları MCP üzerinden yönetebilir.
claude_desktop_config.json dosyasını açalım. Ayarlar kısmına tıklayalım.
Geliştiriciye tıkladıktan sonra dosyanın bulunduğu dizini işletim sistemine göre kontrol edelim.
- Windows:
%APPDATA%\Claude\ - macOS:
~/Library/Application Support/Claude/ - Linux:
~/.config/Claude/
Dosyaya aşağıdaki yapılandırmayı ekleyelim.
{
"mcpServers": {
"mysql": {
"command": "npx",
"args": [
"-y",
"@executeautomation/database-server",
"--mysql",
"--host", "localhost",
"--database", "mysql",
"--port", "3306",
"--user", "root",
"--password", "StrongPasswordHere"
]
}
}
}
Claude Desktop’ı yeniden başlatalım. Geliştirici ayarlarına tekrar döndükten sonra bu sayfayı görmeliyiz.
İkinci bir yöntem olarak ise test sorgusu atabiliriz. Eğer yanıt alıyorsak bağlantı sorunsuz çalışıyor demektir
SELECT NOW();
MCP Üzerinden MySQL’e Sorgu Gönderme
MCP üzerinden MySQL’e bağlantıyı kurduktan sonra Claude ile istediğimiz SQL sorgularını çalıştırabiliriz. MCP, gönderilen komutları MySQL’e iletir ve sonucu düzenli biçimde geri döndürür. SQLite gibi hafif veritabanlarından MySQL’e geçiş yapacaksak, doğru dönüşüm adımlarını uygulamak önemlidir.
Bu süreç için hazırladığımız “SQLite Veritabanından MySQL’e Nasıl Geçilir?” rehberine göz atabilirsiniz.
Bağlantı sorunsuz çalışıyorsa artık örnek sorgulara geçebiliriz.
Tablo listeleme
SHOW TABLES;
Veri çekme
SELECT * FROM kullanıcılar LIMIT 5;
MongoDB, PostgreSQL gibi diğer sistemlerde olduğu gibi MCP’nin MySQL üzerinde sağladığı en büyük avantaj, sorguların tamamen ara katman üzerinden geçmesi ve loglanabilir olmasıdır.
Sık Sorulan Sorular
MCP sunucusu MySQL’e bağlanmıyorsa sorunun kaynağı ne olabilir?
Bu durum çoğunlukla .env dosyasındaki yanlış bağlantı bilgileri, MySQL kullanıcısına eksik verilen izinler veya MySQL servisinin 3306 portunda çalışmamasından kaynaklanır.
MySQL root şifresini bilmiyorsam MCP kurulumu yapabilir miyim?
Root şifresini bilmeden MCP çalışır, ancak veritabanı ve kullanıcı oluşturmanız gerektiğinde root erişimi şarttır. Şifre unutulduysa MySQL’i geçici olarak yetki kontrolü olmadan başlatıp parolayı sıfırlayabilirsiniz.
Claude Desktop MCP sunucusunu algılamıyor?
Genellikle MCP’nin doğru portta çalışmaması, nedeniyle olur. Ayarlara http://localhost:9000 adresini eklediğinizden ve sunucunun gerçekten bu portta dinlediğinden emin olun.
MCP sunucusunun sadece belirli IP’lerden erişilebilir olmasını nasıl sağlarım?
Güvenlik için MCP’yi herkese açık bırakmak yerine belirli IP’lere izin verebilirsiniz. UFW ile şu kural yeterlidir
sudo ufw allow from 127.0.0.1 to any port 9000