MySQL Tabanlı MCP Sunucusu Nasıl Yapılandırılır

Kasım 13, 2025 Soru Yanıt

Bilgisayarınızdaki araçlara yapay zekânın güvenli şekilde ulaşabilmesi için MCP adı verilen özel bir bağlantı kullanılır. Bu yöntem, veritabanı komutlarını doğal dil üzerinden yönetmek isteyen kullanıcılar için ciddi bir kolaylık oluşturur.
MySQL’e MCP Veritabanı Sunucusunu kurarak başlayalım ve sonrasında Claude Desktop entegrasyonunu tamamlayıp sistemi aktif hâle getirelim.

Table of Contents

Kurulum İçin Gerekli Ön Koşullar

MCP sunucusunu çalıştırabilmek için gerekli iki temel bileşen Node.js ve MySQL’dir. Node.js’in 18 ve üzeri bir sürümde, MySQL’in ise 5.7 ya da 8.0 versiyonunda olması gerekir. Daha eski sürümlerde bağlantı hataları veya uyumsuzluklar yaşanabilir.
Node.js kurulumuna başlamadan önce, farklı platformlarda Node.js yapılandırmalarını incelemek isterseniz “Node.js Kurulumu Plesk Panel Üzerinden Nasıl Yapılır?” başlıklı rehbere göz atabilirsiniz.

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 Database Sunucusunu Kurma Adımları

MCP’nin doğru şekilde çalışması için, modelin erişeceği verileri barındıran bir MySQL veritabanı oluşturmak gereklidir. Güvenlik açısından MCP’ye özel bir MySQL hesabı açıp yalnızca gerekli tablolara erişim vermek yeterli olacaktır. Hızlı kurulum için npm kullanılabilirken, geliştirme ortamlarında kaynak koddan derleme yöntemi seçilebilir.
İlk adım olarak 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 ile MCP Sunucu Kurulumu

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ü yerleşik bir araç olarak destekleyen ilk yazılımlardan biridir. Bu destek sayesinde Claude, MySQL veritabanına doğrudan bağlanıp sorguları MCP üzerinden yönetebilir.
claude_desktop_config.json dosyasını açarak Ayarlar kısmına giriş yapalı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 Aracılığıyla MySQL Üzerinde Sorgu Çalıştırma

MySQL ile MCP arasındaki bağlantı kurulduktan sonra, Claude üzerinden ihtiyaç duyulan SQL sorguları rahatça çalıştırılabilir. MCP, aldığı komutları MySQL’e yönlendirir ve çıktıları düzenli bir şekilde geri sunar. SQLite gibi hafif veritabanlarından MySQL’e taşınırken uygun dönüşüm adımlarının takip edilmesi kritik önem taşır.
Detaylı süreç için “SQLite Veritabanını MySQL Platformuna Taşıma Yöntemi” rehberini inceleyebilirsiniz.

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