1. परिचय
Antigravity CLI जैसे एआई एजेंट को अपने डेटाबेस का सुरक्षित और स्ट्रक्चर्ड ऐक्सेस देने के लिए, AlloyDB Omni को MCP Toolbox for Databases के साथ इंटिग्रेट किया जा सकता है.
AlloyDB Omni, PostgreSQL के लिए AlloyDB का डाउनलोड किया जा सकने वाला कंटेनर वर्शन है. इसे कहीं भी चलाया जा सकता है—ऑन-प्राइमिस, डेवलपर वर्कस्टेशन, एज या क्लाउड पर. साथ ही, यह एंटरप्राइज़-ग्रेड PostgreSQL की परफ़ॉर्मेंस और इसके साथ काम करने की सुविधा देता है.
डेटाबेस के लिए एमसीपी टूलबॉक्स, Google का एक ओपन-सोर्स सर्वर है. यह मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) को लागू करता है, ताकि डेटाबेस के साथ इंटरैक्ट करने वाले जनरेटिव एआई टूल को आसानी से, तेज़ी से, और ज़्यादा सुरक्षित तरीके से बनाया जा सके. यह आपके एजेंट के ऑर्केस्ट्रेशन फ़्रेमवर्क और आपके डेटाबेस के बीच काम करता है. साथ ही, यह ये सुविधाएं देता है:
- डेवलपमेंट को आसान बनाना: पहले से बने या कस्टम डेटाबेस टूल, जो कम से कम कॉन्फ़िगरेशन के साथ आपके एजेंट से कनेक्ट होते हैं. साथ ही, इन्हें कई एजेंट या फ़्रेमवर्क में फिर से इस्तेमाल किया जा सकता है.
- बेहतर परफ़ॉर्मेंस: इसमें कनेक्शन पूलिंग और लाइफ़साइकल मैनेजमेंट जैसे सबसे सही तरीके पहले से मौजूद होते हैं.
- बेहतर सुरक्षा: क्रेडेंशियल और पुष्टि करने की प्रोसेस को एक ही जगह से मैनेज किया जाता है. इससे एजेंट को रॉ डेटाबेस क्रेडेंशियल की ज़रूरत नहीं पड़ती.
- शुरू से आखिर तक निगरानी की सुविधा: OpenTelemetry के साथ काम करने की सुविधा पहले से मौजूद होने की वजह से, मेट्रिक और ट्रेसिंग की सुविधा तुरंत उपलब्ध हो जाती है.
इस कोडलैब के आखिर में, आपके पास एक चालू AlloyDB Omni कंटेनर होगा. इसमें ई-कॉमर्स का सैंपल डेटा मौजूद होगा. साथ ही, आपके पास एक एमसीपी टूलबॉक्स सर्वर होगा, जिसमें AlloyDB Omni के एडमिन और क्वेरी के लिए पहले से बने 31 टूल मौजूद होंगे. इसके अलावा, आपके पास कॉन्फ़िगर किया गया Antigravity CLI (agy) एजेंट होगा. यह एजेंट, नैचुरल लैंग्वेज प्रॉम्प्ट का इस्तेमाल करके स्कीमा की जांच कर सकता है, एसक्यूएल क्वेरी चला सकता है, क्वेरी प्लान का विश्लेषण कर सकता है, और डेटाबेस की परफ़ॉर्मेंस का विश्लेषण कर सकता है.

ज़रूरी शर्तें
- Google Cloud Console या Linux वर्कस्टेशन से, Google Cloud प्रोजेक्ट और Cloud Shell का ऐक्सेस.
- Docker इंस्टॉल हो और चल रहा हो.
psqlPostgreSQL क्लाइंट इंस्टॉल हो गया.- Antigravity CLI और एमसीपी टूलबॉक्स को सेट अप करने के लिए,
curlऔरjqइंस्टॉल किया गया.
आपको क्या सीखने को मिलेगा
- Docker का इस्तेमाल करके, AlloyDB Omni डेटाबेस सर्वर कंटेनर को डिप्लॉय और चलाने का तरीका.
- AlloyDB Omni में सैंपल टेबल, डेटा, और इंडेक्स बनाने का तरीका.
- पहले से मौजूद
alloydb-omniटूलसेट की मदद से, डेटाबेस के लिए एमसीपी टूलबॉक्स को डाउनलोड, कॉन्फ़िगर, और शुरू करने का तरीका. - एमसीपी टूलबॉक्स सर्वर से कनेक्ट करने के लिए, Antigravity CLI को एमसीपी क्लाइंट के तौर पर कॉन्फ़िगर करने का तरीका.
- Antigravity CLI में नैचुरल लैंग्वेज प्रॉम्प्ट इस्तेमाल करने का तरीका. इससे डेटाबेस की परफ़ॉर्मेंस की जांच करने, स्कीमा एक्सप्लोर करने, एसक्यूएल क्वेरी चलाने, क्वेरी प्लान का विश्लेषण करने, और रखरखाव से जुड़ी गड़बड़ियों का पता लगाने में मदद मिलती है.
आपको किन चीज़ों की ज़रूरत होगी
- Docker,
psql,curl, औरjqके साथ काम करने वाला टर्मिनल एनवायरमेंट. Google Cloud Shell का इस्तेमाल किया जा सकता है. इसमें ये टूल पहले से इंस्टॉल होते हैं.
2. सेटअप और ज़रूरी शर्तें
प्रोजेक्ट सेटअप
Google Cloud प्रोजेक्ट बनाना
- Google Cloud console में, प्रोजेक्ट चुनने वाले पेज पर, कोई Google Cloud प्रोजेक्ट चुनें या बनाएं.
- पुष्टि करें कि आपके Google Cloud प्रोजेक्ट के लिए बिलिंग की सुविधा चालू है. किसी प्रोजेक्ट के लिए बिलिंग की सुविधा चालू है या नहीं, यह देखने का तरीका जानें.
Cloud Shell शुरू करना
AlloyDB Omni और MCP टूलबॉक्स को अपने लैपटॉप पर स्थानीय तौर पर चलाया जा सकता है. हालांकि, इस कोडलैब में Google Cloud Shell का इस्तेमाल किया जा सकता है. यह क्लाउड में चलने वाला कमांड-लाइन एनवायरमेंट है. इसमें Docker, psql, curl, और jq पहले से इंस्टॉल होते हैं.

- Google Cloud console खोलें और सबसे ऊपर दाईं ओर मौजूद टूलबार में, Cloud Shell चालू करें पर क्लिक करें.Cloud Shell को इनमें से किसी एक तरीके से भी खोला जा सकता है:
- अगर Google Cloud Console का इस्तेमाल किया जा रहा है, तो
Gऔर फिरSदबाएं. - Cloud Shell को सीधे तौर पर खोलें.
- अगर Google Cloud Console का इस्तेमाल किया जा रहा है, तो
आम तौर पर, एनवायरमेंट को सेट अप करने और उससे कनेक्ट करने में कुछ समय लगता है. यह प्रोसेस पूरी होने के बाद, आपको कुछ ऐसा दिखेगा:

3. AlloyDB Omni डेटाबेस सर्वर को तैयार करना और चलाना
इस सेक्शन में, AlloyDB Omni Docker कंटेनर को पुल करके चलाया जाता है. साथ ही, टेस्टिंग के लिए इसमें सैंपल ई-कॉमर्स डेटा भरा जाता है.
AlloyDB Omni डेटाबेस सर्वर को चालू करना
- अपने AlloyDB Omni होस्ट, पोर्ट, डेटाबेस, उपयोगकर्ता, और जनरेट किए गए पासवर्ड के लिए एनवायरमेंट वैरिएबल तय करें:
export ALLOYDB_OMNI_HOST="127.0.0.1" export ALLOYDB_OMNI_PORT="5432" export ALLOYDB_OMNI_DATABASE="postgres" export ALLOYDB_OMNI_USER="postgres" export ALLOYDB_OMNI_PASSWORD="$(openssl rand -hex 8)@1aA" echo "Your generated AlloyDB Omni postgres password is: $ALLOYDB_OMNI_PASSWORD" - Docker का इस्तेमाल करके, AlloyDB Omni कंटेनर को डिटैच्ड मोड में शुरू करें:
docker run --name alloydbomni \ -e POSTGRES_PASSWORD=$ALLOYDB_OMNI_PASSWORD \ -p $ALLOYDB_OMNI_PORT:$ALLOYDB_OMNI_PORT \ -d google/alloydbomni:latest - पुष्टि करें कि कंटेनर चल रहा है और
psqlका इस्तेमाल करके, AlloyDB Omni सर्वर से कनेक्ट किया जा सकता है:docker ps -a until docker exec alloydbomni pg_isready -U "$ALLOYDB_OMNI_USER" -d "$ALLOYDB_OMNI_DATABASE"; do sleep 2; done PGPASSWORD=$ALLOYDB_OMNI_PASSWORD psql -h $ALLOYDB_OMNI_HOST -p $ALLOYDB_OMNI_PORT -U $ALLOYDB_OMNI_USER -d $ALLOYDB_OMNI_DATABASE -c "SELECT 1;"
जांच के लिए सैंपल डेटा बनाना
सैंपल categories, products, customers, और orders टेबल बनाएं, टेस्ट रिकॉर्ड डालें, और इंडेक्स बनाएं, ताकि आप एमसीपी टूलबॉक्स के ज़रिए स्कीमा की जांच, एसक्यूएल क्वेरी, और क्वेरी को लागू करने की योजनाओं की जांच कर सकें:
PGPASSWORD="$ALLOYDB_OMNI_PASSWORD" psql -h $ALLOYDB_OMNI_HOST -p $ALLOYDB_OMNI_PORT -U $ALLOYDB_OMNI_USER -d $ALLOYDB_OMNI_DATABASE << 'EOF'
CREATE TABLE IF NOT EXISTS categories (
category_id SERIAL PRIMARY KEY,
name VARCHAR(50) UNIQUE NOT NULL
);
CREATE TABLE IF NOT EXISTS products (
product_id SERIAL PRIMARY KEY,
product_name VARCHAR(100) UNIQUE NOT NULL,
category VARCHAR(50) NOT NULL,
price NUMERIC(10, 2) NOT NULL,
stock INT DEFAULT 0
);
CREATE TABLE IF NOT EXISTS customers (
customer_id SERIAL PRIMARY KEY,
first_name VARCHAR(50),
last_name VARCHAR(50),
email VARCHAR(100) UNIQUE,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE IF NOT EXISTS orders (
order_id SERIAL PRIMARY KEY,
customer_id INT REFERENCES customers(customer_id),
order_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
total_amount NUMERIC(10, 2)
);
-- Insert sample rows
INSERT INTO categories (name) VALUES
('Smartphones'),
('Laptops'),
('Audio')
ON CONFLICT DO NOTHING;
INSERT INTO products (product_name, category, price, stock) VALUES
('Pixel 9 Pro', 'Smartphones', 999.00, 50),
('MacBook Pro M3', 'Laptops', 1999.00, 20),
('ThinkPad X1 Carbon', 'Laptops', 1450.00, 35),
('Dell XPS 15', 'Laptops', 1700.00, 15),
('Bose QuietComfort', 'Audio', 349.00, 100)
ON CONFLICT DO NOTHING;
INSERT INTO customers (first_name, last_name, email) VALUES
('Ada', 'Lovelace', 'ada@example.com'),
('Alan', 'Turing', 'alan@example.com'),
('Grace', 'Hopper', 'grace@example.com')
ON CONFLICT DO NOTHING;
INSERT INTO orders (order_id, customer_id, total_amount, order_date) VALUES
(1, 1, 999.00, pg_catalog.now() - INTERVAL '7 months'),
(2, 2, 349.00, pg_catalog.now() - INTERVAL '1 month')
ON CONFLICT DO NOTHING;
CREATE INDEX IF NOT EXISTS idx_products_category ON products(category);
CREATE INDEX IF NOT EXISTS idx_orders_customer ON orders(customer_id);
EOF
4. MCP Toolbox सर्वर को चालू करना
इस सेक्शन में, एमसीपी टूलबॉक्स बाइनरी को डाउनलोड किया जाता है, पहले से बने AlloyDB Omni टूल की परिभाषाओं को कॉन्फ़िगर किया जाता है, और एमसीपी टूलबॉक्स सर्वर को चालू किया जाता है.
MCP Toolbox डाउनलोड करें
- एमसीपी टूलबॉक्स के लिए एक डायरेक्ट्री बनाएं और
toolboxबाइनरी डाउनलोड करें:mkdir -p ~/mcp/tools cd ~/mcp curl -L -O https://storage.googleapis.com/genai-toolbox/v0.31.0/linux/amd64/toolbox chmod +x toolbox ./toolbox --version
MCP Toolbox सर्वर को कॉन्फ़िगर करना और शुरू करना
- पहले से कॉन्फ़िगर किए गए
alloydb-omni.yamlटूल डाउनलोड करें और पोर्ट5000पर एमसीपी टूलबॉक्स सर्वर को चालू करें. इसके लिए, पहले एक्सपोर्ट किए गएALLOYDB_OMNI_*एनवायरमेंट वैरिएबल का इस्तेमाल करें:curl -sL --create-dirs -o "tools/alloydb-omni.yaml" "https://raw.githubusercontent.com/googleapis/mcp-toolbox/v0.31.0/internal/prebuiltconfigs/tools/alloydb-omni.yaml" # Remove the trailing group definition block and YAML document separator for --config-folder compatibility sed -i '/^kind: group/,$d' tools/alloydb-omni.yaml sed -i '${/---/d;}' tools/alloydb-omni.yaml ./toolbox --config-folder ./tools/ --port 5000 --address 127.0.0.1alloydb-omni.yamlकॉन्फ़िगरेशन में, पहले से बने 31 टूल मिलते हैं. इनमें इस कोडलैब में दिखाए गए मुख्य टूल भी शामिल हैं:execute_sqlget_query_plandatabase_overviewlist_active_querieslist_tables,list_indexes,list_views,list_triggerslist_top_bloated_tables,list_locks,list_autovacuum_configurations,list_invalid_indexes
alloydb-omni.yamlदेखें. - नए टर्मिनल टैब में, पुष्टि करें कि एमसीपी टूलबॉक्स सर्वर चल रहा है और JSON-RPC
/mcpएंडपॉइंट पर आपके टूल उपलब्ध कराता है:curl -X POST http://localhost:5000/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'
5. एमसीपी क्लाइंट (Antigravity CLI) को कॉन्फ़िगर करना
इस सेक्शन में, Antigravity CLI (agy) को इंस्टॉल करने और उसे अपने एमसीपी टूलबॉक्स सर्वर से कनेक्ट करने के लिए कॉन्फ़िगर करने का तरीका बताया गया है.
Antigravity CLI इंस्टॉल करना
- अगर Antigravity CLI (
agy) पहले से इंस्टॉल नहीं है, तो इसका इंस्टॉलर डाउनलोड करके चलाएं. इसके बाद, वर्शन की पुष्टि करें:curl -fsSL https://antigravity.google/cli/install.sh -o /tmp/install.sh bash /tmp/install.sh rm -f /tmp/install.sh # If prompted by the installer, add ~/.local/bin to your PATH: export PATH="$HOME/.local/bin:$PATH" # Verify the installation agy --version
Antigravity CLI को कॉन्फ़िगर करना
अपने क्लाइंट की एमसीपी कॉन्फ़िगरेशन फ़ाइल में, MCP Toolbox सर्वर की एंट्री जोड़ें. जैसे, Antigravity CLI के लिए ~/.gemini/config/mcp_config.json, Claude Code के लिए .cursor/mcp.json, .vscode/mcp.json, claude_desktop_config.json या .mcp.json.
- पोर्ट
5000पर चल रहे MCP टूलबॉक्स के एचटीटीपी सर्वर से Antigravity CLI को कनेक्ट करने के लिए,agy mcp addको चलाएं. इसके बाद,agy mcp listकी मदद से एंट्री की पुष्टि करें: इससेexport MCP_SERVER="127.0.0.1" export MCP_PORT="5000" agy mcp add alloydb-omni "http://${MCP_SERVER}:${MCP_PORT}/mcp" agy mcp listalloydb-omniसर्वर कॉन्फ़िगरेशन,~/.gemini/config/mcp_config.jsonमें सेव हो जाता है:{ "mcpServers": { "alloydb-omni": { "url": "http://127.0.0.1:5000/mcp" } } }
कॉन्फ़िगरेशन की पुष्टि करें
- Antigravity CLI को शुरू करें:
अगरagyagyको पहली बार लॉन्च किया जा रहा है, तो साइन इन करने के लिए स्क्रीन पर दिए गए निर्देशों का पालन करें. इसके लिए, Google OAuth या Google Cloud प्रोजेक्ट का इस्तेमाल करें. इसके बाद, जब आपसे पूछा जाए कि क्या आपको मौजूदा डायरेक्ट्री पर भरोसा है, तो हां, मुझे इस फ़ोल्डर पर भरोसा है को चुनें. - Antigravity CLI प्रॉम्प्ट में,
/mcpडालें. इससे एमसीपी सर्वर पैनल खुल जाएगा. इसके बाद, पुष्टि करें किalloydb-omniकनेक्ट है: आउटपुट कुछ ऐसा दिखेगा:/mcpMCP Servers Configured (~/.gemini/config/mcp_config.json) > ✓ alloydb-omni Tools: database_overview, execute_sql, get_column_cardinality, get_query_plan, list_active_queries, +26 more Keyboard: ↑/↓ Navigate enter Actions
- एमसीपी सर्वर पैनल को बंद करने और Antigravity CLI प्रॉम्प्ट पर वापस जाने के लिए,
Escदबाएं.
6. AlloyDB Omni के लिए क्वेरी का इस्तेमाल करके जांच करना
अब Antigravity CLI, एमसीपी टूलबॉक्स के ज़रिए आपके AlloyDB Omni इंस्टेंस से कनेक्ट हो गया है. इसलिए, नैचुरल लैंग्वेज प्रॉम्प्ट का इस्तेमाल करके अपने डेटाबेस से इंटरैक्ट किया जा सकता है.
डेटाबेस की खास जानकारी वाली क्वेरी चलाना
- Antigravity CLI प्रॉम्प्ट में, मौजूदा डेटाबेस की खास जानकारी देने के लिए कहें:
टूल को कॉल करने की अनुमति देने के लिए कहा जाने पर, हाँ (या इस बातचीत में हाँ, और हमेशा अनुमति दें) को चुनें. आउटपुट कुछ इस तरह का होता है:Give me an overview of the current database.> Give me an overview of the current database. ● alloydb-omni/database_overview(Database overview check) (ctrl+o to expand) Here is an overview of the current AlloyDB Omni database instance: ### Database Overview • Instance / Engine: PostgreSQL 17.9 (AlloyDB Omni) • Role: Primary (is_replica: false) • Uptime: ~7 hours, 57 minutes • Connected Database: postgres • Connected User: postgres • Connections: 11 current / 100 max (1 active, 11% used) ### Databases in Instance • postgres • alloydbadmin (~15.74 MB) • alloydbmetadata (~14.82 MB)
कैटगरी के हिसाब से टेस्ट के उदाहरण
Antigravity CLI को आम बोलचाल की भाषा में ये अनुरोध करें. एजेंट, हर अनुरोध को AlloyDB Omni एमसीपी टूलसेट में मौजूद उससे जुड़े टूल के साथ अपने-आप मैप कर देता है:
1. डेटाबेस की खास जानकारी और परफ़ॉर्मेंस
टेस्ट का लक्ष्य | नैचुरल लैंग्वेज प्रॉम्प्ट | टूल चालू किया गया |
सिस्टम की जांच |
|
|
चालू कनेक्शन |
|
|
इंस्टॉल किए गए एक्सटेंशन |
|
|
उपलब्ध एक्सटेंशन |
|
|
2. स्कीमा और कैटलॉग एक्सप्लोर करना
टेस्ट का लक्ष्य | नैचुरल लैंग्वेज प्रॉम्प्ट | टूल चालू किया गया |
टेबल की सूची देखना |
|
|
इंडेक्स की जांच करना |
|
|
व्यू एक्सप्लोर करना |
|
|
टेबल ट्रिगर देखना |
|
|
3. डेटा क्वेरी करना और उसे फ़िल्टर करना (execute_sql)
टेस्ट का लक्ष्य | नैचुरल लैंग्वेज प्रॉम्प्ट | टूल चालू किया गया |
एग्रीगेट क्वेरी |
|
|
क्वेरी को जोड़ना |
|
|
मेल न खाने वाले रिकॉर्ड |
|
|
4. क्वेरी की परफ़ॉर्मेंस और प्लान के बारे में जानकारी (get_query_plan)
टेस्ट का लक्ष्य | नैचुरल लैंग्वेज प्रॉम्प्ट | टूल चालू किया गया |
प्लान के बारे में जानकारी दें |
|
|
इंडेक्स की पुष्टि करना |
|
|
5. डेटाबेस का रखरखाव और डाइग्नोस्टिक्स
टेस्ट का लक्ष्य | नैचुरल लैंग्वेज प्रॉम्प्ट | टूल चालू किया गया |
टेबल ब्लोट |
|
|
लॉक का विवाद |
|
|
ऑटोवैक्यूम सेटिंग |
|
|
अमान्य इंडेक्स |
|
|
7. व्यवस्थित करें
कोड लैब पूरा करने के बाद, लोकल कंटेनर और शुरू की गई प्रोसेस को मिटाएं.
- Antigravity CLI से बाहर निकलने के लिए,
/quitटाइप करें याCtrl+Dको दो बार दबाएं. - MCP Toolbox सर्वर चला रहे टर्मिनल टैब पर जाएं और इसे बंद करने के लिए
Ctrl+Cदबाएं. - AlloyDB Omni Docker कंटेनर को बंद करें और हटाएं:
docker stop alloydbomni docker rm alloydbomni
8. बधाई हो
कोडलैब पूरा करने के लिए बधाई! आपने AlloyDB Omni को कंटेनर में डिप्लॉय कर लिया है. साथ ही, पहले से मौजूद AlloyDB Omni टूलसेट की मदद से, डेटाबेस के लिए एमसीपी टूलबॉक्स को कॉन्फ़िगर कर लिया है. इसके अलावा, आपने इसे Antigravity CLI के साथ इंटिग्रेट कर लिया है, ताकि नैचुरल लैंग्वेज का इस्तेमाल करके डेटाबेस को मैनेज किया जा सके और उसमें क्वेरी की जा सके.
आपने क्या कवर किया है
- Docker का इस्तेमाल करके, AlloyDB Omni कंटेनर को डिप्लॉय और उसकी पुष्टि करने का तरीका.
- एजेंट के वर्कफ़्लो की जांच करने के लिए, सैंपल टेबल और इंडेक्स को पॉप्युलेट करने का तरीका.
- पहले से कॉन्फ़िगर किए गए
alloydb-omniटूल के साथ, डेटाबेस के लिए एमसीपी टूलबॉक्स को कॉन्फ़िगर और चलाने का तरीका. - Antigravity CLI को MCP टूलबॉक्स से कनेक्ट करने और स्कीमा खोजने, एसक्यूएल क्वेरी करने, क्वेरी प्लान का विश्लेषण करने, और डेटाबेस की गड़बड़ियों का पता लगाने के लिए, नैचुरल लैंग्वेज प्रॉम्प्ट चलाने का तरीका.
ज़्यादा जानकारी के लिए, ये लेख पढ़ें: