SonarQube MCP

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

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

البحث في المشكلات ونقاط الأمان حسب المشروع والملف والخطورة والنوع
حالة بوابة الجودة واتجاهات المقاييس
بحث القواعد مع الشرح الرسمي ومثال الكود
يعمل مع SonarCloud (مستضاف) وSonarQube self-hosted
قابل للتصفية حسب الفرع / تحليل pull request

عرض مباشر

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

sonarqube-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sonarqube-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "-i",
        "--rm",
        "-e",
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_ORG",
        "mcp/sonarqube"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "sonarqube-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "-i",
        "--rm",
        "-e",
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_ORG",
        "mcp/sonarqube"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "sonarqube-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "-i",
        "--rm",
        "-e",
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_ORG",
        "mcp/sonarqube"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sonarqube-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "-i",
        "--rm",
        "-e",
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_ORG",
        "mcp/sonarqube"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sonarqube-mcp",
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "-i",
        "--rm",
        "-e",
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_ORG",
        "mcp/sonarqube"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "sonarqube-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "--init",
          "--pull=always",
          "-i",
          "--rm",
          "-e",
          "SONARQUBE_TOKEN",
          "-e",
          "SONARQUBE_ORG",
          "mcp/sonarqube"
        ]
      }
    }
  }
}

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

claude mcp add sonarqube-mcp -- docker run --init --pull=always -i --rm -e SONARQUBE_TOKEN -e SONARQUBE_ORG mcp/sonarqube

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

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

استخدامات عملية: SonarQube MCP

إصلاح جماعي لجميع مشكلات قاعدة واحدة في قاعدة الكود

👤 المطورون الذين يسددون الديون التقنية ⏱ ~45 min intermediate

متى تستخدمه: Sonar علّم 47 حالة لنفس القاعدة وتريد إصلاحها جميعاً في PR واحد.

المتطلبات الأساسية

رمز Sonar — User → Security → Generate Token (محدد بمشروع إن أمكن)
Docker متاح — إعداد docker قياسي؛ الصورة تُجلب عند التشغيل الأول

الخطوات

تحديد القاعدة

Use sonarqube-mcp. Top 5 rules by open-issue count in project 'foo'.✓ تم النسخ

→ مفتاح القاعدة + العدد + الخطورة
جلب جميع حالات واحدة منها

List every open issue for rule java:S2293 (Use Diamond Operator) — file, line, snippet.✓ تم النسخ

→ 47 مشكلة مع file:line والكود المحيط
تطبيق الإصلاح

For each, apply the rule's recommended fix. Keep changes minimal; don't reformat.✓ تم النسخ

→ 47 تعديلاً صغيراً عبر ~20 ملفاً
إعادة الفحص للتحقق

After my CI runs the next analysis, recheck the issue count for that rule.✓ تم النسخ

→ العدد يصل إلى صفر

النتيجة: PR واحد مركّز يغلق قاعدة كاملة، بدلاً من 47 commit متفرق.

المزالق

الإصلاح التلقائي للقاعدة يكسر الكود المولّد — فلتر حسب المجلد؛ تخطَّ المسارات المولّدة/الاختبارية أو راجعها يدوياً

اجمعها مع: github · filesystem

تصحيح سبب فشل بوابة الجودة في PR

👤 المطور الذي تم حجب PR الخاص به ⏱ ~30 min intermediate

متى تستخدمه: Sonar يفشّل PR الخاص بك ولوحة التحكم ساحقة.

الخطوات

الحصول على حالة البوابة

Use sonarqube-mcp. Show quality gate status for PR 1234 — which conditions failed?✓ تم النسخ

→ تفصيل البوابة: مثلاً 'New Coverage 67% < 80% threshold'
التعمق في الشرط الفاشل

For 'New Coverage' below threshold — list new lines added in this PR with no test coverage.✓ تم النسخ

→ قائمة سطور جديدة غير مغطاة لكل ملف
إنشاء الاختبارات

Write tests covering those uncovered lines.✓ تم النسخ

→ ملفات اختبار جديدة مضافة؛ استعراض ذهني للحالات

النتيجة: PR مفتوح مع اختبارات موجّهة، لا قنبلة تغطية شاملة.

المزالق

الاختبارات مكتوبة للتغطية لا للسلوك — اطلب من Claude ذكر ما يؤكده كل اختبار؛ ارفض ما لا يحتوي على تأكيد حقيقي

اجمعها مع: github

مراجعة وحل نقاط الأمان الساخنة

👤 المهندسون المهتمون بالأمان ⏱ ~40 min advanced

متى تستخدمه: تراكمت نقاط ساخنة وتحتاج إلى فرزها كـ 'مراجعة آمنة' أو 'تحتاج إصلاحاً'.

الخطوات

قائمة بالنقاط غير المحسومة

Use sonarqube-mcp. List all unreviewed security hotspots in project 'foo' grouped by category.✓ تم النسخ

→ نقاط مجمعة حسب الفئة (مثلاً 'Weak Cryptography'، 'Auth')
شرح المخاطر

For each, summarize the risk in 1 line. Mark which are clearly safe-to-acknowledge vs need-fix.✓ تم النسخ

→ قائمة فرز مُشروحة
الإصلاح أو الإقرار

For need-fix ones, apply the rule's safe pattern. For safe ones, give me the comment to leave on the hotspot review.✓ تم النسخ

→ الإصلاحات مطبقة + تعليقات المراجعة مسودة

النتيجة: نقاط ساخنة مُصفّاة مع مسار مراجعة، لا يتم تجاهلها بصمت.

المزالق

وسم الأشياء كـ 'آمنة' دون تفكير — اطلب من Claude الاستشهاد *بسبب* الأمان في التعليق — هذا يُنشئ مساراً قابلاً للمراجعة

اجمعها مع: github

التركيبات

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

sonarqube-mcp + github

إضافة تعليقات Sonar على PRs أو إنشاء مشكلات تلقائياً للمخالفات الجديدة

On every PR, comment Sonar's gate result and any new issues it added.✓ تم النسخ

sonarqube-mcp + filesystem

تطبيق إصلاحات القواعد محلياً والالتزام بها

Fix all java:S2293 instances; write the diffs locally for review before commit.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
search_issues	project, rules?, severities?, types?, branch?	تصفية المشكلات حسب القاعدة/الخطورة/النوع	1 SonarQube API call
get_rule	rule_key	قراءة الإرشادات الرسمية قبل الإصلاح	1 API call
get_quality_gate	project, branch_or_pr	تشخيص إخفاقات بوابة PR/الفرع	1 API call
search_hotspots	project, status?	مراجعة الأمان	1 API call
get_metrics	project, metric_keys[]	فحوصات الاتجاه/الانجراف (التغطية، التكرارات)	1 API call

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

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

حصة API: حد معدل API لـ Sonar يختلف حسب الإصدار — كن محافظاً في حلقات الجمع
الرموز لكل استدعاء: المشكلات تأتي في صفحات من 100؛ كل مشكلة ~200 رمز
التكلفة المالية: مجاني للمشاريع العامة على SonarCloud؛ ترخيص Enterprise لـ SonarQube
نصيحة: فلتر بشدة في search_issues — التصفح عبر كل شيء مُضيّع

الأمان

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

الحد الأدنى من الصلاحيات: Browse See Source Code

تخزين بيانات الاعتماد: متغير بيئة SONARQUBE_TOKEN، محدد بمشروع

نقل البيانات الخارجي: إلى مثيل Sonar الخاص بك (sonarcloud.io أو self-hosted)

لا تمنح أبدًا: صلاحيات Administer لعامل مُشغَّل بالمحادثة

رموز Sonar تمنح وصولاً لقراءة المصدر — عاملها كسر قابل لقراءة الكود

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

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

401 Unauthorized

أعد توليد الرمز؛ تحقق أن الرمز ليس نطاق مستخدم فقط حين يُحتاج نطاق مشروع

تحقق: curl -u $SONARQUBE_TOKEN: $SONAR_HOST/api/projects/search

منظمة خاطئة

متغير SONARQUBE_ORG يجب أن يطابق slug منظمة Sonar تماماً (أحرف صغيرة)

حاوية Docker لا تصل إلى SonarQube self-hosted

مرّر --network host أو اكشف SonarQube على hostname يمكن الوصول إليه؛ اضبط SONAR_HOST_URL داخل الحاوية

تحقق: docker run ... curl $SONAR_HOST_URL/api/system/status

قائمة المشكلات تبدو قديمة

Sonar يعكس آخر تحليل مكتمل — أعد تشغيل التحليل أو تحقق من طابع وقت آخر تحليل للمشروع

البدائل

SonarQube MCP مقابل البدائل

البديل	متى تستخدمها	المقايضة
CodeQL via GitHub MCP	أنت على GitHub Advanced Security وتريد النتائج في نفس السطح	مجموعة قواعد مختلفة؛ لا مفهوم بوابة الجودة
Semgrep MCP	تريد فحصاً قائماً على الأنماط خفيف الوزن دون بنية تحتية لـ Sonar	تغطية أقل لأكواد smells / مقاييس صيانة

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

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

عرض مباشر

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

التثبيت

اختر العميل

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

استخدامات عملية: SonarQube MCP

إصلاح جماعي لجميع مشكلات قاعدة واحدة في قاعدة الكود

المتطلبات الأساسية

الخطوات

المزالق

تصحيح سبب فشل بوابة الجودة في PR

الخطوات

المزالق

مراجعة وحل نقاط الأمان الساخنة

الخطوات

المزالق

التركيبات

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

الأدوات

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

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

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

الأمان

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

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

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

البدائل

SonarQube MCP مقابل البدائل

المزيد

الموارد