astral uv mcp

نظرة عامة

astral uv mcp (المعروف بشكل شائع باسم uv-mcp) هو خادم بروتوكول سياق النموذج (Model Context Protocol (MCP) server) مفتوح المصدر يعمل كجسر بين أسترال uv — مدير الحزم والمشاريع الخاص بلغة Python المكتوب بلغة Rust والذي يتميز بسرعته الفائقة — وبين وكلاء الذكاء الاصطناعي والأدوات مثل Claude Desktop وClaude Code وGemini CLI.

بدلاً من أن يقتصر دور مساعدي الذكاء الاصطناعي على مجرد اقتراح أوامر uv، يتيح uv-mcp لها أن تفحص وتشخص وتصلح بيئات مشاريع Python مباشرة، مما يحول الذكاء الاصطناعي إلى شريك DevOps فاعل في تطوير Python.

الميزات

• تشخيص البيئة: يحلل تلقائيًا هيكل المشروع والبيئات الافتراضية وتعارضات التبعيات وملفات القفل (uv.lock) وملف pyproject.toml.
• إصلاح ذاتي: ينشئ بيئات افتراضية، ويهيئ المشاريع، ويوائم التبعيات، ويحل المشكلات بمجرد استدعاء أداة واحدة.
• إدارة التبعيات: إضافة أو إزالة أو تحديث الحزم (بما في ذلك تبعيات التطوير) عبر اللغة الطبيعية — لا حاجة لتذكر الوسائط أو الأوامر.
• تكامل أصلي مع uv: يحترم بالكامل سير عمل uv، والبيئات المُدارة خارجيًا وفقًا لـ PEP 668، ويضمن إعدادات قابلة للتكرار باستخدام uv.lock.
• توافق مع MCP: يعمل بسلاسة مع عملاء MCP بما في ذلك Claude وامتدادات Gemini CLI ومنصات وكلاء الذكاء الاصطناعي الأخرى.
• محدود النطاق وآمن: العمليات مقيدة بنطاق المشروع دون تلويث بيئة النظام العام؛ مثالي للحاويات وCI/CD والبيئات المُدارة.
• قابل للتدقيق ومحدد: سجلات واضحة وسلوك متسق عبر الأجهزة لضاءة موثوقية في الأتمتة.

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

• إعداد Python مدعوم بالذكاء الاصطناعي: قل لوكيلك "قم بإعداد مشروع جديد للعلوم البيانات باستخدام pandas وJupyter" — فهو يتولى uv init وإنشاء البيئة الافتراضية وتثبيت التبعيات.
• استكشاف أخطاء البيئة وإصلاحها: يشخص الذكاء الاصطناعي سبب "عدم عمل مشروعي" ويصلحه تلقائيًا.
• حل تعارضات التبعيات: حل التعارضات أو تحديث ملفات القفل دون تدخل يدوي.
• سير عمل متعددة الوكلاء: دمج في عمليات تنسيق أكبر لـ MCP/وكيل الذكاء الاصطناعي لأتمتة تطوير Python الشاملة.
• CI/CD والبنيات القابلة للتكرار: ضمان بيئات متسقة في خطوط الأنابيب الآلية.

التثبيت والبدء السريع

لـ Gemini CLI (مُوصى به)

gemini extensions install https://github.com/saadmanrafat/uv-mcp

لـ Claude Desktop / Code

انسخ المستودع وأضفه إلى إعدادات MCP الخاصة بك (التفاصيل في التوثيق).

يتطلب تثبيت uv (مدير الحزم الخاص بأسترال). أدلة كاملة متاحة في المستودع.

لماذا uv-mcp؟

uv أسرع بالفعل بـ 10-100 مرة من الأدوات التقليدية مثل pip/Poetry. يُعزز uv-mcp من قوته من خلال منح وكلاء الذكاء الاصطناعي وصولًا مباشرًا وآمنًا لقدراته — محولًا عبارة "يعمل على جهازي" إلى قابلية تكرار موثوقة يقودها الوكيل.

الروابط

• GitHub: saadmanrafat/uv-mcp
• الوثائق: saadman.dev/uv-mcp
• الوثائق الرسمية لـ uv: docs.astral.sh/uv

مُبنى لنظام Python الحديث الأصيل للذكاء الاصطناعي.