Veritabanları için Google MCP Toolbox Başlangıç Rehberi

MCP Araç Kutusu'na Giriş

MCP Araç Kutusu, yapay zeka uygulamalarınızın veritabanlarınızla iletişim kurmasına yardımcı olan Google'dan ücretsiz bir araçtır. Onu özel bir çevirmen gibi düşünebilirsiniz. Yapay zekanız bilgiyi basit bir şekilde isteyebilir ve MCP Araç Kutusu bu isteği, veritabanınızın anladığı SQL gibi bir dile çevirir. Bu tür bir iletişim için standart bir kurallar bütünü olan Model Bağlam Protokolü (MCP) adı verilen bir şey kullanır.

Neden MCP Araç Kutusu Kullanmalısınız?

MCP Araç Kutusu sadece bir çevirmen değildir; aynı zamanda yapay zeka uygulamalarınızı oluşturmayı çok daha kolay ve iyi hale getirir.

MCP Araç Kutusu Kodunuzu Basitleştirir

MCP Araç Kutusu olmadan, yapay zekanızı veritabanınıza bağlamak için çok fazla kod yazmanız gerekir. Bağlantı kurma, hataları işleme ve güvenlik için koda ihtiyacınız vardır. MCP Araç Kutusu ile, veritabanı eylemlerinizi tools.yaml adlı basit bir metin dosyasında tanımlarsınız. Bu dosya, araç kutusuna hangi eylemlerin mümkün olduğunu söyler ve araç kutusu, veritabanına güvenli bir şekilde bağlanmanın tüm zor işini halleder.

MCP Araç Kutusu Hızı ve Güvenliği Artırır

MCP Araç Kutusu hızlı olacak şekilde tasarlanmıştır. "Bağlantı havuzu" adı verilen bir teknik kullanır, bu da veritabanı bağlantılarını açık tuttuğu ve yeniden kullandığı anlamına gelir. Bu, her istek için yeni bir bağlantı açmaya kıyasla çok zaman kazandırır. Ayrıca güvenlidir, çünkü tüm veritabanı erişimini tek bir merkezi yerde yönetirsiniz, bu da hata riskini azaltır.

MCP Araç Kutusu Neler Olduğunu Gösterir

Bir yapay zeka, bir araç kutusu ve bir veritabanı birlikte çalıştığında, neler olduğunu görmek zor olabilir. MCP Araç Kutusu, "gözlemlenebilirlik" için yerleşik desteğe sahiptir, bu da her eylemin günlüklerini ve izlerini oluşturabileceği anlamına gelir. Bu, araçlarınızın ne yaptığını anlamanıza, sorunları bulmanıza ve işleri nasıl hızlandıracağınızı görmenize yardımcı olur.

MCP Araç Kutusu Projenize Nasıl Uyar?

MCP Araç Kutusu, uygulamanızın ortasında yer alır. Akış şöyle görünür:

1. Yapay Zeka Uygulamanız: Yapay zeka modelinizin yaşadığı yer burasıdır. Bir soruyu yanıtlamak için veritabanından bilgiye ihtiyacı olduğuna karar verir.
2. MCP Araç Kutusu: Yapay zeka uygulaması, MCP Araç Kutusu'na bir istek gönderir. Araç kutusu, tools.yaml dosyasını inceler, iş için doğru aracı bulur ve veritabanınızda ilgili komutu çalıştırır.
3. Veritabanınız: Veritabanı komutu çalıştırır ve verileri MCP Araç Kutusu'na geri gönderir, o da bu verileri yapay zekanıza iletir.

Bu kurulum, ana yapay zeka uygulamanızın veritabanınızın nasıl çalıştığının karmaşık ayrıntılarını bilmesine gerek olmadığı anlamına gelir. Hatta araçlarınızı veya veritabanınızı, yapay zeka uygulama kodunuzu yeniden yazmak zorunda kalmadan değiştirebilirsiniz.

MCP Araç Kutusu Kullanımına Adım Adım Kılavuz

MCP Araç Kutusu'nu bilgisayarınızda nasıl çalıştıracağımıza bakalım.

Adım 1: Veritabanınızı MCP Araç Kutusu İçin Hazırlayın

Öncelikle bir veritabanına ihtiyacınız var. Bu adımlar örnek olarak PostgreSQL'i kullanır. Araç kutusunun kullanması için özel bir kullanıcı ve bir veritabanı oluşturacaksınız.

PostgreSQL sunucunuza bağlanın.

toolbox_user adında bir kullanıcı ve toolbox_db adında bir veritabanı oluşturmak için bu SQL komutlarını çalıştırın:

CREATE USER toolbox_user WITH PASSWORD 'my-password';
CREATE DATABASE toolbox_db;
GRANT ALL PRIVILEGES ON DATABASE toolbox_db TO toolbox_user;

Araçlarınızın üzerinde çalışabileceği bazı verilere sahip olması için bir hotels tablosu gibi örnek bir tablo oluşturun.

Adım 2: MCP Araç Kutusu'nu Kurun ve Yapılandırın

Ardından, araç kutusunun kendisini kuracaksınız.

MCP Araç Kutusu programını GitHub'daki resmi sürüm sayfasından indirin. Bilgisayarınız için doğru sürümü (Windows, Mac veya Linux gibi) aldığınızdan emin olun.

tools.yaml adında yeni bir dosya oluşturun. Bu dosya, yapay zekanızın gerçekleştirebileceği tüm eylemleri tanımlayacağınız yerdir. İşte basit bir örnek:

sources:
  my-pg-source:
    kind: postgres
    host: 127.0.0.1
    port: 5432
    database: toolbox_db
    user: toolbox_user
    password: my-password

tools:
  search-hotels-by-location:
    kind: postgres-sql
    source: my-pg-source
    description: Belirli bir şehirdeki otelleri bulur.
    parameters:
      - name: location
        type: string
        description: Otel aramak için şehir.
    statement: SELECT * FROM hotels WHERE location = $1;

Adım 3: MCP Araç Kutusu Sunucusunu Çalıştırın

Şimdi araç kutusunu başlatabilirsiniz. Terminalinizi açın, araç kutusunu indirdiğiniz klasöre gidin ve bu komutu çalıştırın:

./toolbox --tools-file "tools.yaml"

Sunucu başlayacak ve tanımladığınız araçları yükleyecektir.

MCP Araç Kutusu Denetleyicisi ile Nasıl Test Edilir?

MCP Araç Kutusu, Denetleyici (Inspector) adı verilen bir test aracıyla birlikte gelir. Bu, herhangi bir kod yazmak zorunda kalmadan araçlarınızı denemenizi sağlayan bir web sayfasıdır.

1. Denetleyiciyi terminalinizden şu komutla çalıştırın: npx @modelcontextprotocol/inspector.
2. Size verdiği web adresini tarayıcınızda açın.
3. Çalışan MCP Araç Kutusu sunucunuza bağlanmasını söyleyin (genellikle http://127.0.0.1:5000/mcp/sse adresinde).
4. Bağlandıktan sonra, araçlarınızın bir listesini görebilir, parametrelerini doldurabilir ve doğru çalışıp çalışmadıklarını görmek için çalıştırabilirsiniz.

Uygulamanızı MCP Araç Kutusu'na Nasıl Bağlarsınız?

Test ettikten sonra, gerçek yapay zeka uygulamanızı bağlayabilirsiniz. MCP Araç Kutusu, bunu kolaylaştırmak için SDK'lara (yazılım geliştirme kitleri) sahiptir. İşte basit bir Python örneği:

Python SDK'sını kurun: pip install toolbox-core.

Araç kutusuna bağlanmak ve araçlarınızı yüklemek için bu kodu kullanın:

from toolbox_core import ToolboxClient
import asyncio

async def main():
    async with ToolboxClient("http://127.0.0.1:5000") as client:
        tools = await client.load_toolset()
        # 'tools' değişkeni artık veritabanı araçlarınızı tutar
        # ve bunları yapay zeka modelinize verebilirsiniz.
        print("Araçlar başarıyla yüklendi!")

asyncio.run(main())

Bu kod, araç kutusu sunucusuna bağlanır ve tanımladığınız araçları indirir. Daha sonra bu araçları yapay zeka aracınıza verebilirsiniz ve aracınız bunları veritabanınızla etkileşim kurmak için kullanabilecektir.

MCP Araç Kutusu Hakkında Son Düşünceler

Google'ın MCP Araç Kutusu, yapay zeka ve veritabanlarıyla çalışan her geliştirici için harika bir araçtır. Kodunuzu basitleştirir, uygulamanızı daha hızlı ve daha güvenli hale getirir ve her şeyin nasıl çalıştığını anlamanız için ihtiyacınız olan görünürlüğü sağlar. Bu kılavuzdaki adımları izleyerek, daha güçlü ve veri odaklı yapay zeka uygulamaları oluşturmak için MCP Araç Kutusu'nu kullanmaya başlayabilirsiniz.