Bitbucket MCP

نظرة عامة

Bitbucket MCP هو خادم مفتوح المصدر لبروتوكول سياق النموذج (MCP) للتكامل مع واجهات برمجة تطبيقات Bitbucket Cloud و Bitbucket Server/Data Center. يتيح للمساعدين الذكاء الاصطناعي (مثل Cursor) التفاعل بأمان مع مستودعات Bitbucket وطلبات السحب والمسارات والموارد الأخرى الخاصة بك مباشرة من خلال الأوامر النصية الطبيعية.

يطبق هذا الخادم معيار MCP ويتم نشره على npm باسم bitbucket-mcp.

الميزات

• عمليات المستودعات: سرد المستودعات وجلب التفاصيل
• دورة حياة طلب السحب: سرد، جلب، إنشاء، تحديث، دمج، موافقة، رفض، إضافة/عرض التعليقات، الفروقات، والمهام
• عمليات المسارات: سرد عمليات التشغيل، تشغيل/إيقاف المسارات، عرض الخطوات والسجلات
• دعم التقسيم إلى صفحات (pagelen, page, all, limit)
• تصميم آمن افتراضيًا: عمليات الحذف معطلة ما لم يتم تعيين BITBUCKET_ENABLE_DANGEROUS=true بشكل صريح

العمليات المدعومة

يعرض الخادم أدوات لسير عمل Bitbucket الشائعة بما في ذلك تصفح المستودعات، إدارة طلبات السحب، أتمتة مراجعة الكود، ومراقبة المسارات. يتم تعريف قائمة الأدوات الكاملة وخرائط API في المصدر.

الأمان وأفضل الممارسات

• يتطلب كلمات مرور تطبيق Bitbucket (أو رموز الوصول) ذات صلاحيات ضئيلة (المستودعات: قراءة؛ طلبات السحب: قراءة/كتابة؛ المسارات: قراءة)
• لا توجد عمليات حذف مفعلة افتراضيًا
• تسجيل قابل للتكوين (قائم على ملفات أو معطل)
• يدعم كلاً من Bitbucket Cloud (https://api.bitbucket.org/2.0) و Bitbucket Server المستضاف ذاتيًا عبر BITBUCKET_URL القابلة للتكوين

التوافق

يعمل مع أي وقت تشغيل ذكاء اصطناعي متوافق مع MCP. تركز أمثلة التكامل الرئيسية على Cursor، مع دعم Bitbucket Cloud و Server.

الروابط

• مستودع GitHub
• حزمة npm
• مرجع واجهة برمجة تطبيقات Bitbucket REST

إعداد MCP

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

• مطلوب Node.js (لـ npx/npm)
• حساب Bitbucket مع كلمة مرور تطبيق أو رمز وصول

متطلبات الوصول

• كلمة مرور تطبيق Bitbucket (المستودعات: قراءة، طلبات السحب: قراءة/كتابة، المسارات: قراءة) أو رمز وصول مطلوب عبر متغيرات البيئة

إعداد العميل

المؤشر (Cursor)

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "env": {
        "BITBUCKET_URL": "https://api.bitbucket.org/2.0",
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_PASSWORD": "your-app-password"
      },
      "args": ["-y", "bitbucket-mcp@latest"]
    }
  }
}

• قم بإنشاء أو تحرير الملف .cursor/mcp.json في جذر مشروعك.
• الصق كتلة التهيئة أعلاه واستبدل العناصر النائبة (your-workspace، your-username، your-app-password) بقيمك الفعلية.

المصادقة:

• تُمرر بيانات الاعتماد عبر متغيرات البيئة في تهيئة MCP. لا حاجة لتسجيل الدخول عبر المتصفح أو خطوات تفويض إضافية.

صيغة الرابط القديمة (https://bitbucket.org/your-workspace) مدعومة أيضًا للكشف التلقائي عن مساحة العمل.

Claude Code

غير موثق

Claude Desktop

غير موثق

VS Code

غير موثق

Codex

غير موثق

Windsurf

غير موثق

Lovable

غير موثق

أخرى

قم بتشغيله عبر npx -y bitbucket-mcp@latest مع متغيرات البيئة المطلوبة (انظر envVars). قم بتهيئته في عميل MCP الخاص بك باستخدام نقل stdio/command.

متغيرات البيئة

• BITBUCKET_URL (الافتراضي: https://api.bitbucket.org/2.0)
• BITBUCKET_WORKSPACE (اختياري، يتم الكشف عنه تلقائيًا من الرابط في الوضع القديم)
• BITBUCKET_USERNAME (بريدك الإلكتروني أو اسم المستخدم في Bitbucket)
• BITBUCKET_PASSWORD (كلمة مرور التطبيق أو رمز API)
• BITBUCKET_TOKEN (بديل عن اسم المستخدم/كلمة المرور)

وثائق الإعداد: https://github.com/MatanYemini/bitbucket-mcp