# Bitbucket MCP

خادم بروتوكول سياق النموذج (MCP) لـ Bitbucket Cloud و Server يتيح للمساعدات الذكية مثل Cursor إدارة المستودعات وطلبات السحب والأنابيب والمزيد عبر اللغة الطبيعية.

Canonical URL: https://a2a-mcp.org/entry/bitbucket-mcp-ar

Language: ar

Category: MCP Servers

Updated: 2026-05-13

## نظرة عامة
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](https://github.com/MatanYemini/bitbucket-mcp)
- [حزمة npm](https://www.npmjs.com/package/bitbucket-mcp)
- [مرجع واجهة برمجة تطبيقات Bitbucket REST](https://developer.atlassian.com/cloud/bitbucket/rest/intro/)

## إعداد MCP

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

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

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

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

### إعداد العميل

#### المؤشر (Cursor)

```json
{
  "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

## Tags

- mcp-server
- bitbucket
- nodejs
- طلبات السحب
- الأنابيب
- المستودعات
- التكامل مع الذكاء الاصطناعي

## Sources

- [Project website](https://github.com/MatanYemini/bitbucket-mcp)