MySQL MCP Server

MySQL veritabanlarıyla güvenli etkileşim sağlayan bir Model Context Protocol (MCP) uygulaması. Bu sunucu bileşeni, AI uygulamaları (host/istemciler) ve MySQL veritabanları arasında iletişimi kolaylaştırarak, veritabanı keşfini ve analizini kontrollü bir arayüz aracılığıyla daha güvenli ve yapılandırılmış hale getirir.

Not: MySQL MCP Server, bağımsız bir sunucu olarak kullanılmak için tasarlanmamıştır. Bunun yerine, AI uygulamaları ve MySQL veritabanları arasında bir iletişim protokolü uygulaması olarak kullanılır.

Özellikler

• Mevcut MySQL tablolarını kaynak olarak listeleme
• Tablo içeriklerini okuma
• Uygun hata işleme ile SQL sorguları yürütme
• Ortam değişkenleri aracılığıyla güvenli veritabanı erişimi
• Kapsamlı günlükleme

Kurulum

Manuel Kurulum

pip install mysql-mcp-server

Smithery Üzerinden Kurulum

MySQL MCP Server'ı Claude Desktop için otomatik olarak Smithery üzerinden kurmak için:

npx -y @smithery/cli install mysql-mcp-server --client claude

Yapılandırma

Aşağıdaki ortam değişkenlerini ayarlayın:

MYSQL_HOST=localhost     # Veritabanı sunucusu
MYSQL_PORT=3306         # İsteğe bağlı: Veritabanı portu (belirtilmezse varsayılan olarak 3306)
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

Kullanım

Claude Desktop ile

Bunu claude_desktop_config.json dosyanıza ekleyin:

{
  "mcpServers": {
    "mysql": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/mysql_mcp_server",
        "run",
        "mysql_mcp_server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Visual Studio Code ile

Bunu mcp.json dosyanıza ekleyin:

{
  "servers": {
      "mysql": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "--from",
                "mysql-mcp-server",
                "mysql_mcp_server"
            ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

Not: Bunun çalışması için uv yüklemeniz gerekecek

MCP Inspector ile Hata Ayıklama

MySQL MCP Server bağımsız olarak çalıştırılmak veya doğrudan Python ile komut satırından çalıştırılmak için tasarlanmamış olsa da, hata ayıklamak için MCP Inspector'ı kullanabilirsiniz.

MCP Inspector, MCP uygulamanızı test etmek ve hata ayıklamak için uygun bir yol sağlar:

# Bağımlılıkları yükleyin
pip install -r requirements.txt
# Hata ayıklama için MCP Inspector'ı kullanın (doğrudan Python ile çalıştırmayın)

MySQL MCP Server, Claude Desktop gibi AI uygulamalarıyla entegre edilmek üzere tasarlanmıştır ve bağımsız bir Python programı olarak doğrudan çalıştırılmamalıdır.

Geliştirme

# Repository'yi klonlayın
git clone https://github.com/designcomputer/mysql_mcp_server.git
cd mysql_mcp_server
# Sanal ortam oluşturun
python -m venv venv
source venv/bin/activate  # Windows'ta `venv\Scripts\activate`
# Geliştirme bağımlılıklarını yükleyin
pip install -r requirements-dev.txt
# Testleri çalıştırın
pytest

Güvenlik Değerlendirmeleri

• Ortam değişkenlerini veya kimlik bilgilerini asla commit etmeyin
• Minimum gerekli izinlere sahip bir veritabanı kullanıcısı kullanın
• Üretim kullanımı için sorgu beyaz listesini uygulamayı düşünün
• Tüm veritabanı işlemlerini izleyin ve günlüğe kaydedin

Güvenlik En İyi Uygulamaları

Bu MCP uygulaması çalışmak için veritabanı erişimi gerektirir. Güvenlik için:

1. Minimum izinlere sahip bir MySQL kullanıcısı oluşturun
2. Root kimlik bilgilerini veya yönetici hesaplarını asla kullanmayın
3. Veritabanı erişimini yalnızca gerekli işlemlerle sınırlayın
4. Günlüklemeyi etkinleştirin denetim amaçları için
5. Veritabanı erişiminin düzenli güvenlik incelemeleri yapın

Aşağıdakiler hakkında ayrıntılı talimatlar için MySQL Güvenlik Yapılandırma Kılavuzu bölümüne bakın:

• Kısıtlı bir MySQL kullanıcısı oluşturma
• Uygun izinleri ayarlama
• Veritabanı erişimini izleme
• Güvenlik en iyi uygulamaları

⚠️ ÖNEMLİ: Veritabanı erişimini yapılandırırken her zaman en az yetki ilkesini takip edin.

Lisans

MIT Lisansı - ayrıntılar için LICENSE dosyasına bakın.

Katkıda Bulunma

1. Repository'yi fork edin
2. Özellik dalınızı oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'Add some amazing feature')
4. Dala push edin (git push origin feature/amazing-feature)
5. Bir Pull Request açın