@f4ww4z/mcp-mysql-server

Model Context Protocol sunucusu, MySQL veritabanı operasyonları sağlar. Bu sunucu, AI modellerinin MySQL veritabanlarıyla standartlaştırılmış bir arayüz üzerinden etkileşim kurmasını sağlar.

Kurulum

Smithery Üzerinden Kurulum

MySQL Server'ı Claude Desktop için Smithery aracılığıyla otomatik olarak kurmak için:

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

Manuel Kurulum

npx @f4ww4z/mcp-mysql-server

Yapılandırma

Sunucu, MCP ayarları yapılandırma dosyanızda aşağıdaki ortam değişkenlerinin ayarlanmasını gerektirir:

önerilen kullanım

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@f4ww4z/mcp-mysql-server", "mysql://user:password@localhost:port/database"],
    }
  }
}

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@f4ww4z/mcp-mysql-server"],
      "env": {
        "MYSQL_HOST": "your_host",
        "MYSQL_USER": "your_user",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

codex

mac

~/.codex/config.toml dosyasında

[mcp_servers.mcp-mysql-server]
command = "npx"
args = [
  "-y",
  "@f4ww4z/mcp-mysql-server",
  "mysql://user:password@127.0.0.1:3306/database"
]

windows

%USERPROFILE%\.codex\config.toml dosyasında

[mcp_servers.mcp-mysql-server]
command = "npx"
args = [
  "-y",
  "@f4ww4z/mcp-mysql-server",
  "mysql://user:password@127.0.0.1:3306/database"
]

Evals çalıştırma

Evals paketi bir mcp client yükler ve ardından index.ts dosyasını çalıştırır, bu nedenle testler arasında yeniden derleme yapmanıza gerek yoktur. npx komutunu önek yaparak ortam değişkenlerini yükleyebilirsiniz. Tam belgelendirme burada bulunabilir.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

Kullanılabilir Araçlar

1. connect_db

Sağlanan kimlik bilgilerini kullanarak MySQL veritabanına bağlantı kurun.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    host: "localhost",
    user: "your_user",
    password: "your_password",
    database: "your_database"
  }
});

2. query

SELECT sorgularını isteğe bağlı hazırlanmış statement parametreleriyle yürütün.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "query",
  arguments: {
    sql: "SELECT * FROM users WHERE id = ?",
    params: [1]
  }
});

3. execute

INSERT, UPDATE veya DELETE sorgularını isteğe bağlı hazırlanmış statement parametreleriyle yürütün.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "execute",
  arguments: {
    sql: "INSERT INTO users (name, email) VALUES (?, ?)",
    params: ["John Doe", "john@example.com"]
  }
});

4. list_tables

Bağlı veritabanındaki tüm tabloları listeleyin.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "list_tables",
  arguments: {}
});

5. describe_table

Belirli bir tablonun yapısını alın.

use_mcp_tool({
  server_name: "mysql",
  tool_name: "describe_table",
  arguments: {
    table: "users"
  }
});

Özellikler

• Otomatik temizleme ile güvenli bağlantı yönetimi
• Query parametreleri için hazırlanmış statement desteği
• Kapsamlı hata yönetimi ve doğrulama
• TypeScript desteği
• Otomatik bağlantı yönetimi

Güvenlik

• SQL injection'ı önlemek için hazırlanmış ifadeleri kullanır
• Ortam değişkenleri aracılığıyla güvenli parola yönetimini destekler
• Yürütülmeden önce sorguları doğrular
• İşlem tamamlandığında bağlantıları otomatik olarak kapatır

Hata Yönetimi

Sunucu, yaygın sorunlar için ayrıntılı hata mesajları sağlar:

• Bağlantı hataları
• Geçersiz sorgular
• Eksik parametreler
• Veritabanı hataları

Katkıda Bulunma

Katkılar hoş karşılanır! Lütfen https://github.com/f4ww4z/mcp-mysql-server adresine bir Pull Request göndermekten çekinmeyin.

Lisans

MIT