Panduan Pemula Google MCP Toolbox untuk Database

Pengantar MCP Toolbox

MCP Toolbox adalah alat gratis dari Google yang membantu aplikasi AI Anda berkomunikasi dengan database Anda. Anggap saja sebagai penerjemah khusus. AI Anda dapat meminta informasi dengan cara yang sederhana, dan MCP Toolbox menerjemahkan permintaan tersebut ke dalam bahasa yang dipahami database Anda, seperti SQL. Ini menggunakan sesuatu yang disebut Model Context Protocol (MCP), yang hanyalah seperangkat aturan standar untuk jenis komunikasi ini.

Mengapa Anda Harus Menggunakan MCP Toolbox

MCP Toolbox bukan hanya penerjemah; ini juga membuat pembangunan aplikasi AI Anda jauh lebih mudah dan lebih baik.

MCP Toolbox Membuat Kode Anda Lebih Sederhana

Tanpa MCP Toolbox, Anda harus menulis banyak kode hanya untuk menghubungkan AI Anda ke database Anda. Anda memerlukan kode untuk koneksi, untuk penanganan kesalahan, dan untuk keamanan. Dengan MCP Toolbox, Anda cukup mendefinisikan tindakan database Anda dalam file teks sederhana yang disebut tools.yaml. File ini memberi tahu toolbox tindakan apa yang mungkin dilakukan, dan toolbox menangani semua pekerjaan sulit untuk terhubung ke database dengan aman.

MCP Toolbox Meningkatkan Kecepatan dan Keamanan

MCP Toolbox dirancang agar cepat. Ini menggunakan teknik yang disebut "connection pooling," yang berarti ia menjaga koneksi database tetap terbuka dan menggunakannya kembali. Ini menghemat banyak waktu dibandingkan dengan membuka koneksi baru untuk setiap permintaan. Ini juga aman karena Anda mengelola semua akses database di satu tempat terpusat, mengurangi risiko kesalahan.

MCP Toolbox Menunjukkan Apa yang Terjadi

Ketika Anda memiliki AI, toolbox, dan database yang semuanya bekerja bersama, mungkin sulit untuk melihat apa yang sedang terjadi. MCP Toolbox memiliki dukungan bawaan untuk "observability," yang berarti ia dapat membuat log dan jejak setiap tindakan. Ini membantu Anda memahami apa yang dilakukan alat Anda, menemukan masalah apa pun, dan melihat bagaimana membuat segalanya lebih cepat.

Bagaimana MCP Toolbox Cocok dalam Proyek Anda

MCP Toolbox berada di tengah aplikasi Anda. Alurnya terlihat seperti ini:

1. Aplikasi AI Anda: Di sinilah model AI Anda berada. Ia memutuskan membutuhkan informasi dari database untuk menjawab pertanyaan.
2. MCP Toolbox: Aplikasi AI mengirimkan permintaan ke MCP Toolbox. Toolbox melihat file tools.yaml-nya, menemukan alat yang tepat untuk pekerjaan itu, dan menjalankan perintah yang sesuai pada database Anda.
3. Database Anda: Database menjalankan perintah dan mengirimkan data kembali ke MCP Toolbox, yang kemudian meneruskannya ke AI Anda.

Pengaturan ini berarti aplikasi AI utama Anda tidak perlu mengetahui detail rumit tentang cara kerja database Anda. Anda bahkan dapat mengubah alat atau database Anda tanpa harus menulis ulang kode aplikasi AI Anda.

Panduan Langkah demi Langkah untuk Menggunakan MCP Toolbox

Mari kita bahas cara membuat MCP Toolbox berfungsi di komputer Anda.

Langkah 1: Siapkan Database Anda untuk MCP Toolbox

Pertama, Anda memerlukan database. Langkah-langkah ini menggunakan PostgreSQL sebagai contoh. Anda akan membuat pengguna khusus dan database untuk digunakan oleh toolbox.

Hubungkan ke server PostgreSQL Anda.

Jalankan perintah SQL ini untuk membuat pengguna bernama toolbox_user dan database bernama toolbox_db:

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

Buat tabel contoh, seperti tabel hotels, agar alat Anda memiliki beberapa data untuk dikerjakan.

Langkah 2: Instal dan Konfigurasi MCP Toolbox

Selanjutnya, Anda akan menyiapkan toolbox itu sendiri.

Unduh program MCP Toolbox dari halaman rilis resminya di GitHub. Pastikan untuk mendapatkan versi yang tepat untuk komputer Anda (seperti Windows, Mac, atau Linux).

Buat file baru bernama tools.yaml. File ini adalah tempat Anda akan mendefinisikan semua tindakan yang dapat dilakukan AI Anda. Berikut adalah contoh sederhana:

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: Finds hotels in a specific city.
    parameters:
      - name: location
        type: string
        description: The city to search for hotels in.
    statement: SELECT * FROM hotels WHERE location = $1;

Langkah 3: Jalankan Server MCP Toolbox

Sekarang Anda dapat memulai toolbox. Buka terminal Anda, masuk ke folder tempat Anda mengunduh toolbox, dan jalankan perintah ini:

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

Server akan dimulai dan memuat alat yang Anda definisikan.

Cara Menguji dengan MCP Toolbox Inspector

MCP Toolbox dilengkapi dengan alat pengujian yang disebut Inspector. Ini adalah halaman web yang memungkinkan Anda mencoba alat Anda tanpa harus menulis kode apa pun.

1. Jalankan Inspector dari terminal Anda dengan perintah ini: npx @modelcontextprotocol/inspector.
2. Buka alamat web yang diberikannya di browser Anda.
3. Perintahkan untuk terhubung ke server MCP Toolbox Anda yang sedang berjalan (biasanya di http://127.0.0.1:5000/mcp/sse).
4. Setelah terhubung, Anda dapat melihat daftar alat Anda, mengisi parameternya, dan menjalankannya untuk melihat apakah alat tersebut berfungsi dengan benar.

Cara Menghubungkan Aplikasi Anda ke MCP Toolbox

Setelah pengujian, Anda dapat menghubungkan aplikasi AI Anda yang sebenarnya. MCP Toolbox memiliki SDK (software development kits) untuk mempermudah hal ini. Berikut adalah contoh Python sederhana:

Instal Python SDK: pip install toolbox-core.

Gunakan kode ini untuk terhubung ke toolbox dan memuat alat Anda:

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()
        # Variabel 'tools' sekarang menyimpan alat database Anda
        # dan Anda dapat memberikannya ke model AI Anda.
        print("Alat berhasil dimuat!")

asyncio.run(main())

Kode ini terhubung ke server toolbox dan mengunduh alat yang Anda definisikan. Anda kemudian dapat memberikan alat ini kepada agen AI Anda, dan ia akan dapat menggunakannya untuk berinteraksi dengan database Anda.

Pemikiran Akhir tentang MCP Toolbox

MCP Toolbox dari Google adalah alat yang fantastis untuk setiap pengembang yang bekerja dengan AI dan database. Ini menyederhanakan kode Anda, membuat aplikasi Anda lebih cepat dan lebih aman, serta memberi Anda visibilitas yang Anda butuhkan untuk memahami bagaimana semuanya berfungsi. Dengan mengikuti langkah-langkah dalam panduan ini, Anda dapat mulai menggunakan MCP Toolbox untuk membangun aplikasi AI yang lebih kuat dan berbasis data.