MySQL Üzerinde MCP Sunucusu Nasıl Yapılandırılır

yazar

Yapay zekânın bilgisayarınızdaki araçlara güvenli biçimde erişebilmesi için MCP adı verilen bir bağlantı kullanılır. Bu mekanizma, veritabanı işlemlerini doğal dil üzerinden yönetmek isteyen kullanıcılar için büyük kolaylık sunar.
MySQL üzerinde MCP Veritabanı Sunucusunu birlikte kuralım ve ardından Claude Desktop bağlantısını yapılandırarak tüm sistemi çalışır hâle getirelim.

Kuruluma Başlamadan Önce Gerekenler

MCP sunucusunun doğru şekilde çalışması içinNode.js ve MySQL’in kurulu olması şarttır. Node.js’in 18 ve üzeri, MySQL’in de 5.7 veya 8.0 versiyonunda bulunması gerekir. Daha eski versiyonlar bağlantı aşamasında uyumsuzluk oluşturabilir.

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 Sisteme Kurmak

MCP’nin çalışması için önce modelin sorgu gerçekleştireceği verileri içeren bir MySQL veritabanı hazırlanmalıdır. Güvenliği artırmak için MCP adına ayrı bir MySQL kullanıcısı oluşturup yalnızca ilgili tablolara yetki vermek yeterlidir. Kurulumu hızlı yapmak için npm tercih edilebilir; geliştirme hedefleyen kullanıcılar ise kaynak koddan derlemeyi seçebilir.
İşe MySQL’e giriş yaparak başlayalı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 Kullanarak MCP Kurulumunu 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ç düzeyinde destekleyen ilk uygulamalardan biridir. Bu sayede Claude, MySQL veritabanına doğrudan bağlanabilir ve tüm sorguları MCP katmanı üzerinden işleyebilir.
claude_desktop_config.json dosyasını açalım ve Ayarlar bölümüne geçelim.

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 Bağlantısı ile MySQL Sorgulama İşlemleri

MCP bağlantısı başarıyla gerçekleştirildiğinde, Claude ile MySQL üzerinde istediğimiz SQL sorgularını çalıştırabiliriz. MCP, komutları MySQL’e aktarır ve sonuçları düzenli bir şekilde geri iletir. SQLite gibi hafif veritabanlarından MySQL’e geçiş yapılacaksa, uygun dönüşüm sürecinin takip edilmesi önemlidir.
Detaylı adımlar için “SQLite Verilerini MySQL’e Aktarma Adımları” 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.

Mysql root şifresi sıfırlama

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

Yorum yapın