Veritabanları İçin MCP Toolbox, AI ajanlarınızı, IDE'lerinizi ve uygulamalarınızı doğrudan kurumsal veritabanlarınıza bağlayan açık kaynaklı bir Model Context Protocol (MCP) sunucusudur.

İkili bir amaca hizmet eder:

1. Hazır Kullanıma Sunulan MCP Sunucusu (Derleme Zamanı): Gemini CLI, Google Antigravity, Claude Code, Codex veya diğer MCP istemcilerini önceden oluşturulmuş genel araçlar kullanarak veritabanlarınıza anında bağlayın. Verilerinizle konuşun, şemaları keşfedin ve boilerplate yazmadan kod oluşturun.
2. Özel Araçlar Çerçevesi (Çalışma Zamanı): Üretim ajanları için özelleştirilmiş, yüksek düzeyde güvenli AI araçları geliştirmek için sağlam bir çerçeve. Yapılandırılmış sorguları, anlamsal aramayı ve NL2SQL özelliklerini güvenli ve kolay bir şekilde tanımlayın.

Bu README kısa bir özet sağlamaktadır. Kapsamlı ayrıntılar için tam belgelendirmeyi inceleyin.

[!IMPORTANT]
Depo Adı Güncellemesi: genai-toolbox deposu resmi olarak mcp-toolbox olarak yeniden adlandırılmıştır. Yerel ortamınızı yeni adla senkronize etmek için uzak kaynağınızı güncelleme yapabilirsiniz: git remote set-url origin https://github.com/googleapis/mcp-toolbox.git

[!NOTE] Bu çözüm başlangıçta "Veritabanları İçin Gen AI Toolbox" (github.com/googleapis/genai-toolbox) olarak adlandırılmıştır; bu ad ilk geliştirme MCP'den daha öncesine dayanır, ancak MCP uyumluluğu sağlamak için yeniden adlandırılmıştır.

İçindekiler

• Neden MCP Toolbox?
• Hızlı Başlangıç: Hazır Araçlar
• Hızlı Başlangıç: Özel Araçlar
• Toolbox Sunucusunu Yükleyin ve Çalıştırın
• Toolbox'a Bağlanın
  • MCP İstemcisi
  • Toolbox SDK'ları: Uygulamanızla Entegre Olun
• Ek Özellikler
• Sürüm Kontrolü
• Katkıda Bulunma
• Topluluk

Neden MCP Toolbox?

• Hazır Veritabanı Erişimi: IDE veya CLI'dan anında veri keşfi için önceden oluşturulmuş genel araçlar (ör. list_tables, execute_sql).
• Özel Araçlar Çerçevesi: Kendi önceden tanımlanmış mantığınızla üretim hazır araçlar oluşturun; Sınırlı Erişim, Yapılandırılmış Sorgular ve Anlamsal Arama yoluyla güvenlik sağlanır.
• Basitleştirilmiş Geliştirme: Araçları Agent Development Kit (ADK), LangChain, LlamaIndex veya özel ajanlar içine 10 satırdan az kodla entegre edin.
• Daha İyi Performans: Bağlantı havuzu yönetimi, entegre auth (IAM) ve uçtan uca gözlemlenebilirlik (OpenTelemetry) kutudan çıktığında kullanıma sunulur.
• Geliştirilmiş Güvenlik: Verilerinize daha güvenli erişim için entegre kimlik doğrulama.
• Uçtan Uca Gözlemlenebilirlik: OpenTelemetry desteğiyle kutudan çıktığında metrikler ve izleme.

Hızlı Başlangıç: Hazır Araçlar

Bağlam değiştirmeyi bırakın ve AI asistanınızı gerçek bir yer ortağı yapın. MCP Toolbox ile IDE'nizi veritabanlarınıza bağlayarak, verilerinizi düz İngilizce ile sorgulayabilir, şema keşfi ve yönetimini otomatikleştirebilir ve veritabanı bilgisine sahip kod oluşturabilirsiniz.

Toolbox'u herhangi bir MCP uyumlu IDE veya istemcide (ör. Gemini CLI, Google Antigravity, Claude Code, Codex, vb.) MCP sunucusunu yapılandırarak kullanabilirsiniz.

Hazır araçlar ayrıca Google Antigravity MCP Store aracılığıyla basit bir tıkla kurulum deneyimiyle kullanılabilir.

1. İstemcinizin MCP yapılandırma dosyasına (genellikle mcp.json veya claude_desktop_config.json) aşağıdakini ekleyin:

   {
     "mcpServers": {
       "toolbox-postgres": {
         "command": "npx",
         "args": [
           "-y",
           "@toolbox-sdk/server",
           "--prebuilt=postgres",
           "--stdio"
         ]
       }
     }
   }
   

2. Bağlanmak için uygun ortam değişkenlerini ayarlayın, bkz. Hazır Araçlar Referansı.

Toolbox'u --prebuilt=<database> bayrağı ile çalıştırdığınızda, o veritabanıyla etkileşim kurmanız için anında standart araçlara erişebilirsiniz.

Şu anda desteklenen veritabanları şunları içerir:

• Google Cloud: AlloyDB, BigQuery, Cloud SQL (PostgreSQL, MySQL, SQL Server), Spanner, Firestore, Knowledge Catalog (daha önce Dataplex olarak bilinirdi).
• Diğer Veritabanları: PostgreSQL, MySQL, SQL Server, Oracle, MongoDB, Redis, Elasticsearch, CockroachDB, ClickHouse, Couchbase, Neo4j, Snowflake, Trino ve daha fazlası.

Tüm desteklenen veritabanları genelinde kullanılabilir araçların ve yeteneklerinin tam listesi için Hazır Araçlar Referansı bölümüne bakın.

Docker veya ikili dosyalar gibi farklı yürütme yöntemleri için Toolbox Sunucusunu Yükleyin ve Çalıştırın bölümüne bakın.

[!TIP] Yönetilen bir çözüm arayan kullanıcılar için Google Cloud MCP Sunucuları önceden oluşturulmuş araçlarla yönetilen bir MCP deneyimi sağlar; burada farklılıklar hakkında bilgi edinebilirsiniz.

Hızlı Başlangıç: Özel Araçlar

Toolbox ayrıca özelleştirilmiş araçlar için bir çerçeve olarak kullanılabilir. Toolbox'u yapılandırmanın birincil yolu tools.yaml dosyasıdır. Birden çok dosyanız varsa, --config tools.yaml bayrağını kullanarak hangisini yükleyeceğini Toolbox'a söyleyebilirsiniz.

Tüm kaynak türlerine daha ayrıntılı referans belgelendirmesini Kaynaklar bölümünde bulabilirsiniz.

Kaynaklar

tools.yaml dosyasının sources bölümü, Toolbox'un hangi veri kaynaklarına erişim sahibi olması gerektiğini tanımlar. Çoğu araç yürütmek için en az bir kaynağa sahip olacaktır.

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

Farklı kaynak türlerini yapılandırma hakkında daha fazla ayrıntı için Kaynaklar bölümüne bakın.

Araçlar

tools.yaml dosyasının tools bölümü bir ajanın gerçekleştirebileceği eylemleri tanımlar: araç türü nedir, hangi kaynakları etkiler, hangi parametreleri kullanır, vb.

kind: tool
name: search-hotels-by-name
type: postgres-sql
source: my-pg-source
description: Search for hotels based on name.
parameters:
  - name: name
    type: string
    description: The name of the hotel.
statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';

Farklı araç türlerini yapılandırma hakkında daha fazla ayrıntı için Araçlar bölümüne bakın.

Araç Setleri

tools.yaml dosyasının toolsets bölümü, birlikte yüklemek istediğiniz araçlardan oluşan grupları tanımlamanıza olanak sağlar. Bu, farklı grupları ajen veya uygulamaya göre tanımlamak için yararlı olabilir.

kind: toolset
name: my_first_toolset
tools:
    - my_first_tool
    - my_second_tool
---
kind: toolset
name: my_second_toolset
tools:
    - my_second_tool
    - my_third_tool

İstemler

tools.yaml dosyasının prompts bölümü, LLM'lerle etkileşimlerde kullanılabilecek istemler tanımlar.

kind: prompt
name: code_review
description: "Asks the LLM to analyze code quality and suggest improvements."
messages:
  - content: >
         Please review the following code for quality, correctness,
         and potential improvements: \n\n{{.code}}
arguments:
  - name: "code"
    description: "The code to review"

İstemler yapılandırma hakkında daha fazla ayrıntı için İstemler bölümüne bakın.

Toolbox Sunucusunu Yükleyin ve Çalıştırın

Toolbox'u doğrudan bir yapılandırma dosyası ile çalıştırabilirsiniz:

npx @toolbox-sdk/server --config tools.yaml

Bu, yapılandırma dosyanızla Toolbox sunucusunun en son sürümünü çalıştırır.

[!NOTE] Bu yöntem kolaylık açısından optimize edilmiştir; performans açısından değil. Daha standart ve güvenilir bir kurulum için lütfen Toolbox Sunucusunu Yükleyin ve Çalıştırın bölümünde açıklandığı gibi ikili dosya veya container görüntüsü kullanın.

Toolbox'u Yükleyin

En son sürüm için sürümler sayfasını kontrol edin ve işletim sisteminiz ve CPU mimarisi için aşağıdaki talimatları kullanın.

# diğer sürümler için sürümler sayfasına bakın
export VERSION=1.3.0
docker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION

brew install mcp-toolbox

go install github.com/googleapis/mcp-toolbox@v1.3.0

# Gemini CLI'yi yükleyin
npm install -g @google/gemini-cli
# Uzantıyı yükleyin
gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-postgres
# Gemini CLI'yi çalıştırın
gemini

# Uzantıyı yükleyin
gemini extensions install https://github.com/gemini-cli-extensions/mcp-toolbox

Toolbox'u Çalıştırın

Araçlarınızı tanımlamak için configure bölümünde tools.yaml dosyasını yapılandırın ve ardından sunucuyu başlatmak için toolbox komutunu yürütün:

./toolbox --config "tools.yaml"

export VERSION=0.24.0 # Çektiğiniz sürümü kullanın
docker run -p 5000:5000 \
-v $(pwd)/tools.yaml:/app/tools.yaml \
us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION \
--config "/app/tools.yaml"

go run .

toolbox --config "tools.yaml"

npx @toolbox-sdk/server --config tools.yaml

# Gemini CLI'yi çalıştırın
gemini

# Uzantıları listeleyin
/extensions list
# MCP sunucularını listeleyin
/mcp list

Tüm bayraklar için bir liste almak istiyorsanız toolbox help kullanabilirsiniz! Sunucuyu durdurmak için bir sonlandırma sinyali gönderin (çoğu platformda ctrl+c).

Farklı ortamlara dağıtım hakkında daha detaylı belgelendirme için Toolbox'u Dağıt bölümü içindeki kaynakları kontrol edin

Toolbox'a Bağlanın

Toolbox sunucunuz çalışır duruma geldikten sonra, araçları MCP uyumlu istemcinize veya uygulamanıza yükleyebilirsiniz.

MCP İstemcisi

MCP istemcinizin yapılandırmasına aşağıdakini ekleyin:

{
  "mcpServers": {
    "toolbox": {
      "type": "http",
      "url": "http://127.0.0.1:5000/mcp",
    }
  }
}

Belirli bir araç setine bağlanmak istiyorsanız, URL'yi "http://127.0.0.1:5000/mcp/{toolset_name}" ile değiştirin.

Toolbox SDK'ları: Uygulamanızla Entegre Olun

Toolbox Client SDK'ları, özel uygulamalarınızı MCP Toolbox sunucusuna bağlamak için kolay kullanılan yapı taşları ve gelişmiş özellikler sağlar. Aşağıda çeşitli çerçeveleri kullanmak için Client SDK'larının listesini görebilirsiniz: