charted MCP: ابدأ بـ uvx واستدعِ list_chart_types ثم ارسم

لمن يناسب

تريد أن يُخرج وكيل رسوم SVG أو PNG ولا تريد إدخال charted أولاً في اعتماديات المشروع. مسار MCP الرسمي يستخدم uvx لتشغيل charted مع MCP extra في بيئة لمرة واحدة ويخدم عبر stdio. المكتبة الأساس بلا اعتماديات زمن تشغيل؛ تصدير PNG وMCP إضافات اختيارية تجلب اعتمادياتها، والقاعدة تبقى بايثون خالصاً.

يناسب السؤال أولاً عن أنواع الرسوم والمواضيع ثم تقرير التوليد. النص الرسمي يذكر 15 نوعاً. في المحاولة الأولى لا تسلك ملاحظات pip غير الموسّعة.

المستودع الرسمي في سطر وحده:

https://github.com/marzukia/charted

مرساة تفاصيل الأدوات في سطر وحده:

https://github.com/marzukia/charted#mcp-server-ai-agent-integration

أول محاولة في 3 دقائق

اتبع أمر uvx هذا فقط:

uvx --from charted[mcp] charted-mcp

تسجيل Claude Code هو:

claude mcp add charted -- uvx --from charted[mcp] charted-mcp

يضع Cursor وCline والعملاء الآخرون الأمر نفسه في إعداد MCP لكل منهم. لا تثبّت بيئة افتراضية داخل المشروع كمسار رئيس بالتوازي.

المتطلب: يوجد uvx على هذا الجهاز. يجلب uvx إضافة MCP الخاصة بـ charted إلى بيئة لمرة واحدة.

موضع الإعداد: يستخدم Claude Code سطر add؛ ويضع الآخرون أمر uvx نفسه في إعداد MCP server ويقلعون عبر stdio.

الخطوة الأولى منخفضة المخاطر: استدعِ list_chart_types لإعادة أنواع الرسوم. أو list_themes لإعادة المواضيع. كلاهما جرد ولا ينشئ ملفات. إشارة النجاح مجموعة أنواع أو مواضيع. لا تفهم ذلك الجرد على أنه بلا شبكة: ما زال uvx يجلب الحزمة ويشغّل عملية محلية.

إن بدت المجموعة طبيعية فكّر بعدها في الرسم. يولّد create_chart رسماً ويرسم chart_from_csv من CSV. الرسم يُنتج SVG أو PNG لدى الوكيل وليس قراءة فقط. قبل الاستدعاء أكّد أن البيانات يجوز أن تدخل هذه البيئة لمرة واحدة؛ وبعده الحصول على رسم هو إشارة النجاح. النص الرسمي لا يكتب مسار إخراج على القرص ولا أمر تراجع.

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

الحالة الأولى: انظر أولاً أي الأنواع مدعومة. استدعِ list_chart_types. استدعِ list_themes إن احتجت مواضيع. النص الرسمي يعطي أسماء الأدوات فقط ولا يعدد الأنواع الـ 15.

الحالة الثانية: ارسم من بيانات منظَّمة أو CSV. استدعِ create_chart أو chart_from_csv من CSV. يمكن أن يكون الخرج SVG أو PNG. PNG مثل MCP هو extra اختياري opt-in. النص الرسمي لا يعطي أسماء حقول ولا أسماء مواضيع ولا اتفاق أعمدة CSV.

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

المسار الرئيس هو uvx --from charted[mcp] charted-mcp؛ لا تجعل مسار pip المحاولة الأولى. أساس بلا اعتماديات لا يعني MCP extra بلا اعتماديات. هذه الصفحة تسمّي فقط create_chart وlist_chart_types وlist_themes وchart_from_csv. للرسم آثار جانبية. readOnlyHint ليس صفر مخاطر. يذكر النص الرسمي أيضاً Claude skill، لكن هذه المقتطفات لا تكتب خطوات تثبيت الـ skill.