/ الدليل / الملعب / gemini-mcp-tool
← كل الخوادم ↗ GitHub
● مجتمع jamubc ⚡ فوري

gemini-mcp-tool

بواسطة jamubc · jamubc/gemini-mcp-tool

اسمح لـ Claude باستدعاء أداة Gemini CLI لتحليل الملفات في سياق واسع — استخدم نافذة الـ token المليون في Gemini كعملية فرعية.

يربط jamubc/gemini-mcp-tool بين Claude (أو أي عميل MCP) وأداة Gemini CLI. ثلاث أدوات: ask-gemini (تحليل الملفات باستخدام صيغة @)، sandbox-test (تشغيل الكود في بيئة الحماية الخاصة بـ Gemini)، Ping. يتيح لك نقل تحليل الملفات الضخمة وتحليل قواعد الأكواد الكبيرة إلى سياق الـ 1M-token في Gemini.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

gemini-mcp-tool.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "gemini-mcp-tool": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "gemini-mcp-tool": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "gemini-mcp-tool": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "gemini-mcp-tool": {
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "gemini-mcp-tool",
      "command": "npx",
      "args": [
        "-y",
        "gemini-mcp-tool"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "gemini-mcp-tool": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "gemini-mcp-tool"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add gemini-mcp-tool -- npx -y gemini-mcp-tool

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: gemini-mcp-tool

كيفية تحليل ملف ضخم لا يناسب سياق Claude

👤 المطورون الذين يعملون مع سجلات ضخمة أو قواعد أكواد أو مستندات ⏱ ~15 min intermediate

متى تستخدمه: عندما لا يستطيع Claude استيعاب الملف، لكن Gemini يستطيع.

المتطلبات الأساسية
  • أداة Gemini CLI + مفتاح Google API — npm i -g @google/gemini-cli؛ ثم اضبط gemini config باستخدام مفتاحك من aistudio.google.com
  • تثبيت MCP — claude mcp add gemini-cli -- npx -y gemini-mcp-tool
الخطوات
  1. نقل التحليل
    ask-gemini: @/var/log/app-2026-04.log — ابحث عن جميع أخطاء 5xx المجمعة حول النشرات في آخر 72 ساعة، وقدم جدولاً.✓ تم النسخ
    → يحلل Gemini ويعيد ملخصاً مختصراً
  2. التحليل التفصيلي باستخدام Claude
    بناءً على ملخص Gemini، ركز على التجمع حول 2026-04-12 14:30 UTC واقترح السبب الجذري.✓ تم النسخ
    → يحلل Claude الملخص

النتيجة: نتيجة لا يستطيع أي من النموذجين وحده إنتاجها في خطوة واحدة.

المزالق
  • إرسال السجلات الحساسة إلى Gemini — أزل المعلومات الشخصية قبل استدعاء ask-gemini أو استخدم نموذجاً مُستضافاً ذاتياً بدلاً من ذلك
  • تكلفة token على Gemini Pro للمدخلات الضخمة — استخدم Gemini Flash للتكلفة؛ Pro فقط عندما تكون الدقة مهمة
اجمعها مع: filesystem

كيفية مراجعة قاعدة أكواد صغيرة بأكملها في خطوة واحدة

👤 المهندسون الذين يدققون في الخدمات الصغيرة ⏱ ~20 min intermediate

متى تستخدمه: تريد مراجعة شاملة تأخذ بعين الاعتبار كل ملف في نفس الوقت.

الخطوات
  1. تسليم المستودع كاملاً
    ask-gemini: @./src/ — راجع من حيث المشاكل الهيكلية والأنماط المكررة التي يجب تجريدها والكود الميت.✓ تم النسخ
    → ملاحظات عملية على مستوى المستودع
  2. تقسيم الاقتراحات حسب الأولوية
    من بينها، ما هي الـ 3 الأكثر تأثيراً؟ سمِّ الملفات.✓ تم النسخ
    → قائمة مرتبة حسب الأولوية

النتيجة: يتم إنتاج مراجعة أولية للمراجع في خطوة واحدة.

المزالق
  • يفقد Gemini التفاصيل في المستودعات الضخمة — إذا تجاوزت src/ الـ 500k token، فقلل النطاق إلى المجلدات الفرعية
اجمعها مع: github

كيفية تنفيذ الكود غير الآمن في بيئة حماية Gemini

👤 المطورون الذين يختبرون مقاطع أكواد غير موثوقة ⏱ ~5 min beginner

متى تستخدمه: تريد تجربة تشغيل شيء ما دون السماح له بالوصول إلى جهازك.

الخطوات
  1. إرسال إلى بيئة الحماية
    sandbox-test: قم بتشغيل سكريبت Python هذا [الصق] — أبلغ عن stdout/stderr ورمز الخروج.✓ تم النسخ
    → الناتج بدون آثار جانبية على جهازك

النتيجة: نتيجة تنفيذ آمنة.

المزالق
  • بيئة الحماية لا تتمتع بالإنترنت افتراضياً لمعظم المقاطع — تحقق من وثائق بيئة حماية Gemini CLI لخيارات الاتصال

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

gemini-mcp-tool + filesystem

اختيار الملفات محلياً وتمرير مراجع @ إلى Gemini

اسرد جميع ملفات *.log المعدلة اليوم عبر نظام الملفات، ثم استدعِ ask-gemini @ لكل ملف للبحث عن الشذوذ.✓ تم النسخ
gemini-mcp-tool + github

مراجعة PR من خلال تسليم الـ diff الكامل إلى سياق Gemini الواسع

جلب الـ diff الخاص بـ PR #4421 عبر github MCP، ثم استدعِ ask-gemini لنقد الـ diff كاملاً كتغيير متماسك واحد.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
ask-gemini prompt: str (may include @path refs), model?: 'flash'|'pro' تحليل السياق الواسع Gemini API call — Flash ~$0.075/1M input, Pro higher
sandbox-test code: str, language? تشغيل الكود غير الموثوق Gemini sandbox billing
Ping فحص سلامة الاتصال free

التكلفة والحدود

تكلفة التشغيل

حصة API
Gemini AI Studio له طبقة مجانية؛ الطبقة المدفوعة دفع مقابل كل token
الرموز لكل استدعاء
كبير — هذه هي النقطة الأساسية. خطط لـ 100k-500k token لكل استدعاء.
التكلفة المالية
Gemini 2.5 Flash حوالي $0.075 لكل 1M مدخل؛ Pro أعلى بحوالي 20 مرة
نصيحة
استخدم Flash افتراضياً. ارتقِ إلى Pro فقط عندما يكون Flash واضحاً أنه خاطئ.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: مفتاح Gemini API
تخزين بيانات الاعتماد: تخزن أداة Gemini CLI المفتاح في ~/.config/gemini/
نقل البيانات الخارجي: يذهب محتوى الملف إلى Google Gemini؛ يخضع لسياسة بيانات Gemini API من Google
لا تمنح أبدًا: لا تمرر الأسرار في الملفات المشار إليها بـ @ — فهي تذهب مباشرة إلى Google

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

gemini-cli not found

ثبّت عالمياً: npm i -g @google/gemini-cli؛ تأكد من وجود npm global bin على PATH.

تحقق: which gemini
401 from Gemini

شغّل gemini config لضبط مفتاح API الخاص بك من aistudio.google.com.

تحقق: gemini 'hello'
Token limit exceeded

حتى Gemini لديه حدود؛ قلل مراجع @ أو استخدم البحث لتضييق الملفات أولاً.

Sandbox timeout

يتطلب الكود طويل التشغيل مهلة زمنية أعلى؛ أو شغّله محلياً في حاوية بدلاً من ذلك.

البدائل

gemini-mcp-tool مقابل البدائل

البديلمتى تستخدمهاالمقايضة
deep-research MCPتريد بحثاً مستقلاً وليس الوصول المباشر إلى Geminiشكل مختلف؛ يتضمن البحث على الويب
openrouter MCPتريد الوصول إلى عدة نماذج عبر مفتاح واحدلا توجد صيغة @-file؛ أقل ملاءمة للسياق الواسع

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills