۱. قبل از شروع
شما باید به یک نمونهی در حال اجرا از Looker دسترسی داشته باشید. به یک API client_id و client_secret نیاز خواهید داشت.
پیشنیازها
- یک نمونه Looker در حال اجرا داشته باشید
- به خط فرمان لینوکس یا macOS دسترسی داشته باشید
آنچه یاد خواهید گرفت
- نحوه نصب رابط خط فرمان Gemini
- نحوه نصب جعبه ابزار MCP
- نحوه اتصال Gemini CLI به Looker با استفاده از MCP Toolbox
آنچه نیاز دارید
- آدرس اینترنتی (URL) سرور Looker API. این معمولاً همان آدرس اینترنتی Looker است، اما ممکن است لازم باشد شماره پورتی مانند
:19999را اضافه کنید، برای مثال:https://looker.example.com:19999. اگر همه چیز درست کار نکرد، از مدیر Looker خود بپرسید.
۲. آمادهسازیها
شما باید client_id و client_secret را بازیابی کنید.
وارد نمونه Looker خود شوید و روی نمایه کاربر در گوشه سمت راست بالای صفحه کلیک کنید. حساب را انتخاب کنید. در صفحه حساب، کنار برچسب API Keys ، دکمه Manage را فشار دهید.
در صفحه مدیریت کلیدهای API ، دکمه Create New API Key را فشار دهید.
در ورودی تازه ایجاد شده، MCP Toolbox هدف یا چیزی شبیه به آن را اضافه کنید و برای ذخیره آن، روی علامت تیک کلیک کنید. سپس client_id و client_secret را در جایی امن کپی و جایگذاری کنید. برای مشاهده و کپی کردن آن، باید نماد چشم کنار secret را فشار دهید.
اکنون میتوانید پنجرههای مرورگر Looker را ببندید.
۳. نصب رابط خط فرمان Gemini
برای دسترسی به خط فرمان macOS یا Linux، برنامه ترمینال را باز کنید.
دستور زیر را اجرا کنید:
npm install -g @google/gemini-cli
اگر به هر دلیلی موفق نشدید، برای گزینههای نصب یا راهنمایی به https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation مراجعه کنید.
حالا Gemini CLI را با این دستور اجرا کنید:
gemini
از شما خواسته میشود که وارد سیستم شوید. دستورالعملها را دنبال کنید و آمادهی شروع خواهید بود.
۴. جعبه ابزار MCP را نصب کنید
ایجاد دایرکتوری جعبه ابزار 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
به انتهای آن خط توجه ویژه داشته باشید. اگر از لینوکس استفاده میکنید، با x86_64 GNU/Linux تمام میشود. برای macOS، Darwin و یا arm64 برای پردازنده اپل یا x86_64 i386 برای پردازنده اینتل در انتهای آن رشته نشان داده میشود.
دانلود جعبه ابزار MCP
اگر لینوکس دارید، دستور زیر را برای دانلود MCP Toolbox اجرا کنید:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/linux/amd64/toolbox
اگر macOS با پردازنده اپل دارید، دستور زیر را برای دانلود MCP Toolbox اجرا کنید:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/arm64/toolbox
اگر macOS با پردازنده اینتل دارید، دستور زیر را برای دانلود MCP Toolbox اجرا کنید:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox
جعبه ابزار MCP را قابل اجرا کنید
با اجرای دستور زیر، برنامه MCP Toolbox را قابل اجرا کنید:
chmod +x toolbox
مسیر کامل toolbox را دریافت کنید
با اجرای دستور زیر، مسیر کامل فایل toolbox را دریافت کنید:
echo $HOME/mcp-toolbox/toolbox
احتمالاً نتیجهای شبیه به این خواهد داشت:
/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox
نتیجه را در جایی مناسب ذخیره کنید.
۵. پیکربندی رابط خط فرمان Gemini
فایل $HOME/.gemini/settings.json را ویرایش کنید. از ویرایشگر متن دلخواه خود استفاده کنید. اگر زیاد فایلها را در لینوکس یا 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 کنید. فایل ویرایش شده را ذخیره کنید.
۶. استفاده از جعبه ابزار MCP به همراه رابط خط فرمان Gemini
با وارد کردن دستور gemini در خط فرمان، رابط خط فرمان Gemini را اجرا کنید.
با تایپ کردن دستور زیر در پنجره 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 به آنها پاسخ داد: «کل درآمد من برای سال ۲۰۲۵ چقدر است؟»، «در سهماهه چهارم چند ابزارک فروختم؟» و غیره.
۷. دستورالعملهای بیشتر برای امتحان کردن
همچنین میتوانید Looks و داشبوردهای ذخیره شده را اجرا کنید، Looks و داشبورد ایجاد کنید، حتی مدلهای LookML را ویرایش کنید.
- با وارد کردن عبارتی مانند «اجرای ظاهر «موجودی ماهانه»» یک ظاهر ذخیرهشده را اجرا کنید. Gemini باید ظاهری با نام «موجودی ماهانه» را جستجو کند، سپس عبارت مرتبط را اجرا کرده و نتایج را به اشتراک بگذارد.
- با دادن دستوری مانند «خلاصه داشبورد «ردیابی مشتری»» یک داشبورد اجرا کنید. Gemini باید داشبوردی با نام «ردیابی مشتری» را جستجو کند، پرسوجوهای مرتبط با هر بخش را اجرا کند و خلاصهای ارائه دهد.
- برای ایجاد یک نمای ذخیره شده، از اعلانی مانند «ایجاد یک نمای برای پیگیری درآمد ماهانه من به تفکیک دسته بندی محصولات. نمایش دادهها به صورت یک نمودار ستونی انباشته» استفاده کنید.
- برای ایجاد یک داشبورد، از عبارتی مانند «یک داشبورد فروش برای سال ۲۰۲۶ برای من بساز» استفاده کنید.
اگر شما یک توسعهدهنده LookML هستید، میتوانید LookML را با Gemini تغییر دهید. با دستوراتی مانند اینها آزمایش کنید:
- Gemini را وادار کنید تا فهرست پروژههای LookML را با عبارت «چه پروژههای LookML موجود است؟» دریافت کند.
- از Gemini بخواهید لیست فایلهای پروژه را بازیابی کند. "چه فایلهایی در پروژه PROJECT_NAME موجود است؟" نام پروژه خود را جایگزین کنید.
- از Gemini بخواهید یک معیار اضافه کند. "یک معیار برای میانگینگیری فیلد sales_price در نمای VIEW_NAME ایجاد کنید." نام نمای خودتان را جایگزین کنید.
- فهرست اتصالات را با عبارت «چه اتصالاتی در Looker موجود است؟» بازیابی کنید.
- طرحوارههای مرتبط را دریافت کنید. «چه طرحوارههایی در CONNECTION_NAME وجود دارند؟» نام اتصال خود را جایگزین کنید.
- جداول مرتبط را دریافت کنید. "چه جداولی در CONNECTION_NAME در طرحواره SCHEMA_NAME قرار دارند؟" نام اتصال و طرحواره خود را جایگزین کنید.
- ستونهای یک جدول را دریافت کنید. «چه ستونهایی در TABLE_NAME وجود دارند؟» نام جدول خودتان را جایگزین کنید.
- حالا از Gemini بخواهید یک ستون به نمای LookML اضافه کند. "یک بُعد برای ستون COLUMN_NAME ایجاد کنید." نام ستون خودتان را جایگزین کنید.
از رابط کاربری Looker برای آزمایش تغییرات و احتمالاً ثبت آنها استفاده کنید. Gemini و MCP Toolbox نمیتوانند تغییرات LookML را ثبت کرده و آنها را به محیط عملیاتی منتقل کنند.