1. शुरू करने से पहले
आपके पास चालू Looker इंस्टेंस का ऐक्सेस होना चाहिए. इसके लिए, आपको एपीआई client_id और client_secret की ज़रूरत होगी.
ज़रूरी शर्तें
- Looker इंस्टेंस चालू होना चाहिए
- आपके पास Linux या macOS की कमांड लाइन का ऐक्सेस हो
आपको क्या सीखने को मिलेगा
- Gemini CLI इंस्टॉल करने का तरीका
- MCP Toolbox को इंस्टॉल करने का तरीका
- MCP Toolbox का इस्तेमाल करके, Gemini CLI को Looker से कनेक्ट करने का तरीका
आपको इन चीज़ों की ज़रूरत होगी
- Looker API सर्वर का यूआरएल. यह आम तौर पर Looker यूआरएल जैसा ही होता है. हालांकि, आपको पोर्ट नंबर जोड़ना पड़ सकता है. जैसे,
:19999. उदाहरण के लिए:https://looker.example.com:19999. अगर आपको कोई समस्या आ रही है, तो अपने Looker एडमिन से संपर्क करें.
2. तैयारियां
आपको client_id और client_secret को फिर से पाना होगा.
अपने Looker इंस्टेंस में लॉग इन करें. इसके बाद, स्क्रीन के सबसे ऊपर दाएं कोने में मौजूद उपयोगकर्ता प्रोफ़ाइल पर क्लिक करें. खाता चुनें. खाता स्क्रीन पर, API Keys लेबल के बगल में मौजूद, Manage बटन दबाएं.
एपीआई पासकोड मैनेज करने वाले पेज पर, Create New API Key बटन दबाएं.
नई एंट्री में, मकसद MCP Toolbox या उससे मिलती-जुलती कोई जानकारी जोड़ें. इसके बाद, इसे सेव करने के लिए सही के निशान पर क्लिक करें. इसके बाद, client_id और client_secret को किसी सुरक्षित जगह पर कॉपी करके चिपकाएं. सीक्रेट को देखने और कॉपी करने के लिए, आपको उसके बगल में मौजूद 'आंख' आइकॉन को दबाना होगा.
अब Looker की ब्राउज़र विंडो बंद की जा सकती हैं.
3. Gemini CLI इंस्टॉल करना
macOS या Linux कमांड लाइन पर जाने के लिए, टर्मिनल ऐप्लिकेशन खोलें.
यह कमांड चलाएं:
npm install -g @google/gemini-cli
अगर किसी वजह से यह तरीका काम नहीं करता है, तो इंस्टॉल करने के विकल्पों या मदद पाने के लिए, https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation पर जाएं.
अब इस कमांड का इस्तेमाल करके Gemini CLI चलाएं:
gemini
आपको लॉगिन करने के लिए कहा जाएगा. उन निर्देशों का पालन करें. इसके बाद, आपको कोई समस्या नहीं आएगी.
4. MCP Toolbox इंस्टॉल करना
MCP टूलबॉक्स डायरेक्ट्री बनाना
अपने टर्मिनल ऐप्लिकेशन में, एक डायरेक्ट्री mcp-toolbox बनाएं. इसके बाद, उस डायरेक्ट्री में जाएं:
mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox
सिस्टम आर्किटेक्चर की पहचान करना
यह जानने के लिए कि आपके पास किस तरह का सिस्टम है, uname कमांड चलाएं:
uname -a
इस कमांड से, कुछ इस तरह की स्ट्रिंग मिलेगी:
Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux
उस लाइन के आखिर में दिए गए टेक्स्ट पर ध्यान दें. अगर Linux का इस्तेमाल किया जा रहा है, तो यह x86_64 GNU/Linux पर खत्म होगा. macOS के लिए, यह Darwin और उस स्ट्रिंग के आखिर में, Apple प्रोसेसर के लिए arm64 या Intel प्रोसेसर के लिए x86_64 i386 दिखाएगा.
MCP टूलबॉक्स डाउनलोड करें
अगर आपके पास Linux है, तो MCP Toolbox को डाउनलोड करने के लिए यह कमांड चलाएं:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/linux/amd64/toolbox
अगर आपके पास Apple प्रोसेसर वाला macOS है, तो MCP Toolbox डाउनलोड करने के लिए यह कमांड चलाएं:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/arm64/toolbox
अगर आपके पास Intel प्रोसेसर वाला macOS है, तो MCP Toolbox डाउनलोड करने के लिए, यह कमांड चलाएं:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox
MCP टूलबॉक्स को एक्ज़ीक्यूटेबल बनाना
नीचे दी गई कमांड चलाकर, MCP टूलबॉक्स प्रोग्राम को एक्ज़ीक्यूटेबल बनाएं:
chmod +x toolbox
टूलबॉक्स का पूरा पाथ पाना
टूलबॉक्स फ़ाइल का पूरा पाथ पाने के लिए, यह कमांड चलाएं:
echo $HOME/mcp-toolbox/toolbox
इससे शायद कुछ ऐसा नतीजा मिलेगा:
/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox
नतीजे को किसी ऐसी जगह पर सेव करें जहां से उसे आसानी से ऐक्सेस किया जा सके.
5. Gemini CLI को कॉन्फ़िगर करना
$HOME/.gemini/settings.json फ़ाइल में बदलाव करें. अपने पसंदीदा टेक्स्ट एडिटर का इस्तेमाल करें. अगर आपको Linux या macOS में फ़ाइलों में अक्सर बदलाव नहीं करना होता है, तो nano एक अच्छा विकल्प है.
json फ़ाइल में यह स्टैंज़ा जोड़ें:
"mcpServers": {
"looker": {
"command": "FULL_PATH_TO_TOOLBOX",
"args": [
"--stdio",
"--prebuilt",
"looker"
],
"env": {
"LOOKER_BASE_URL": "URL_OF_LOOKER_INSTANCE",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "true"
}
}
}
FULL_PATH_TO_TOOLBOX, URL_OF_LOOKER_INSTANCE, CLIENT_ID, और CLIENT_SECRET के लिए, पिछले चरणों में सेव की गई जानकारी डालें. बदलाव की गई फ़ाइल सेव करें.
6. Gemini CLI के साथ MCP Toolbox का इस्तेमाल करना
कमांड लाइन में gemini डालकर, Gemini CLI शुरू करें.
Gemini के प्रॉम्प्ट में यह टाइप करके, उपलब्ध टूल की सूची देखें:
/mcp list looker
आपका नतीजा कुछ ऐसा दिखना चाहिए:
Configured MCP servers: 🟢 looker - Ready (33 tools) Tools: - add_dashboard_element - add_dashboard_filter - create_project_file - delete_project_file - dev_mode - generate_embed_url - get_connection_databases - get_connection_schemas - get_connection_table_columns - get_connection_tables - get_connections - get_dashboards - get_dimensions - get_explores - get_filters - get_looks - get_measures - get_models - get_parameters - get_project_file - get_project_files - get_projects - health_analyze - health_pulse - health_vacuum - make_dashboard - make_look - query - query_sql - query_url - run_dashboard - run_look - update_project_file
अब Gemini सीएलआई से, उपलब्ध डेटा के बारे में सवाल पूछें. इनमें से कुछ तरीके आज़माएं:
- Looker में कौनसे मॉडल उपलब्ध हैं?
- MODEL_NAME में कौनसे एक्सप्लोर उपलब्ध हैं?
- EXPLORE_NAME में कौनसे मेज़र और डाइमेंशन उपलब्ध हैं?
MODEL_NAME और EXPLORE_NAME के लिए, अपनी वैल्यू डालें.
इसके बाद, कुछ क्वेरी आम भाषा में लिखें. ये ऐसी क्वेरी होनी चाहिए जिनके जवाब आपके Looker इंस्टेंस में मौजूद डेटा से दिए जा सकें: "साल 2025 में मेरा कुल रेवेन्यू कितना है?", "मैंने चौथी तिमाही में कितने विजेट बेचे?" वगैरह.
7. इन प्रॉम्प्ट को भी आज़माया जा सकता है
सेव किए गए लुक और डैशबोर्ड को चलाने, लुक और डैशबोर्ड बनाने, और LookML मॉडल में बदलाव करने की कोशिश भी की जा सकती है.
- सेव किए गए किसी लुक को चलाने के लिए, "‘महीने के हिसाब से इन्वेंट्री' लुक चलाओ" जैसा कोई प्रॉम्प्ट डालें. Gemini को ‘मंथली इन्वेंट्री' नाम की लुकबुक खोजनी चाहिए. इसके बाद, उससे जुड़ी क्वेरी को चलाना चाहिए और नतीजे शेयर करने चाहिए.
- "'ग्राहक ट्रैकिंग' डैशबोर्ड की खास जानकारी दो" जैसा प्रॉम्प्ट देकर, डैशबोर्ड चलाएं. Gemini को ‘ग्राहक ट्रैकिंग' नाम का डैशबोर्ड खोजना चाहिए. साथ ही, हर टाइल से जुड़ी क्वेरी को चलाना चाहिए और खास जानकारी देनी चाहिए.
- सेव किया गया लुक बनाने के लिए, इस तरह का प्रॉम्प्ट आज़माएं: "मेरे हर महीने के रेवेन्यू को प्रॉडक्ट कैटगरी के हिसाब से ट्रैक करने के लिए, एक लुक बनाओ. डेटा को स्टैक किए गए कॉलम चार्ट के तौर पर दिखाओ."
- डैशबोर्ड बनाने के लिए, "साल 2026 के लिए, मुझे सेल्स पल्स डैशबोर्ड बनाओ" जैसा प्रॉम्प्ट आज़माएं.
अगर आप LookML डेवलपर हैं, तो Gemini की मदद से LookML में बदलाव किया जा सकता है. इस तरह के प्रॉम्प्ट आज़माएं:
- Gemini को "कौनसे LookML प्रोजेक्ट उपलब्ध हैं?" प्रॉम्प्ट देकर, LookML प्रोजेक्ट की सूची पाएं
- Gemini को प्रोजेक्ट फ़ाइलों की सूची वापस पाने के लिए प्रॉम्प्ट करें. "PROJECT_NAME प्रोजेक्ट में कौनसी फ़ाइलें उपलब्ध हैं?" अपने प्रोजेक्ट का नाम डालें.
- Gemini को कोई मेज़र जोड़ने के लिए प्रॉम्प्ट करें. "VIEW_NAME व्यू में sales_price फ़ील्ड का औसत निकालने के लिए, मेज़र बनाएं." अपने व्यू का नाम डालें.
- "Looker में कौन-कौनसे कनेक्शन उपलब्ध हैं?" सवाल पूछकर, कनेक्शन की सूची पाएं
- इससे जुड़े स्कीमा पाएं. "CONNECTION_NAME में कौनसे स्कीमा हैं?" कनेक्शन का अपना नाम डालें.
- इससे जुड़ी टेबल पाएं. "स्कीमा SCHEMA_NAME में CONNECTION_NAME में कौनसी टेबल हैं?" अपने कनेक्शन और स्कीमा के नाम बदलें.
- किसी टेबल के कॉलम पाएं. "TABLE_NAME में कौनसे कॉलम हैं?" अपनी टेबल का नाम डालें.
- अब Gemini से LookML व्यू में एक कॉलम जोड़ने के लिए कहें. "कॉलम COLUMN_NAME के लिए डाइमेंशन बनाओ." अपने कॉलम का नाम डालें.
बदलावों को टेस्ट करने और उन्हें लागू करने के लिए, Looker के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करें. Gemini और MCP टूलबॉक्स, LookML में बदलाव नहीं कर सकते और उन्हें प्रोडक्शन में पुश नहीं कर सकते.