Rome CLI + MCP

أداة سطر الأوامر للمطورين في Rome وخادم MCP — حقائق سلسلة موثوقة، ونمط البناء الصحيح، والإجراءات الخاصة بـRome (تمويل، نشر، تحقق) لمستخدم بشري أو وكيل ذكاء اصطناعي.

روما يحمل الباني — إنسانًا كان أو وكيل ذكاء اصطناعي — عبر دورة البناء على روما كاملة: حقائق سلسلة مؤصَّلة، النمط الصحيح، استدعاءات العقود، مسار الدخول للتمويل، النشر/الإرسال، التشخيص عبر الآلات الافتراضية المختلفة، وبوابة تحقق تعمل على كلا المسارين. نواة قدرة واحدة، وواجهتان متطابقتان — واجهة CLI (روما <command>) و MCP خادم (rome mcp) — بحيث يشترك الوكيل والبشر في نموذج ذهني واحد.

التثبيت

أولًا المستودع (لا يزال نشر npm قيد الانتظار):

# تشغيل لمرة واحدة، بلا تثبيت:
npx github:rome-protocol/rome-cli facts chain hadrian

# تثبيت دائم — استنساخ + ربط:
git clone https://github.com/rome-protocol/rome-cli
cd rome-cli && npm install && npm install -g .

أمر بسيط npm install -g github:rome-protocol/rome-cli لا يعمل اليوم — يقوم npm بإعداد تبعيات git للحزمة من دون مجلدات node_modules الخاصة بها (rome-cli#25). استخدم تشغيل npx لمرة واحدة أو الاستنساخ + الربط. ثبّت وسمًا (github:rome-protocol/rome-cli#v0.8.0) عندما تحتاج إلى تشغيلات قابلة لإعادة الإنتاج.

طبقتان فوق نواة واحدة

القراءات — التأصيل + التشخيص. لا مفاتيح؛ على كلٍ من CLI وخادم MCP.

الأمر	ما يعيده
روما حقائق السلسلة·الرموز·العقود·الغاز·الرصيد·البرامج	حقائق حية عن السلسلة من السجل + RPC — بلا معرّفات أو عناوين أو محددات وهمية
روما كُتيّب الوصفات الأنماط·cpi-recipe·الأخطاء	أي مثال يناسب هدفك · قواعد حسابات CPI التي يخطئ فيها الوكلاء · فكّ فشل روما → السبب + الإصلاح
rome call <chain> <addr> <sig> [args]	قراءة عقد (eth_call) — الوسائط متعددة القيم تُمرَّر مفصولة بفواصل ضمن وسيطة واحدة: "0xOwner…,0xSpender…"
rome doctor <chain>	فحص مسبق — هل السلسلة تعمل؟ هل يمكن الوصول إلى RPC؟ هل البرنامج مُهيّأ؟ هل المحفظة ممولة؟
rome tx <chain> <hash>	تشخيص معاملة — إيصال EVM + معاملات التسوية على سولانا + رابط Via (روما لا يملك debug_trace*)
rome preset foundry|hardhat <chain>	إعداد شبكة روما جاهز لسلسلة أدواتك + الخصائص الغريبة

الإجراءات — التوقيع على السلسلة. على CLI فقط، والمفتاح من البيئة، أبدًا على MCP.

الأمر	ما الذي يفعله
rome deploy <chain> <artifact>	نشر عقد مُجمَّع، مع التعامل مع خصائص غاز روما الغريبة
rome send <chain> <addr> <sig>	الكتابة إلى عقد عبر مسار الكتابة الصحيح في روما
rome fund <chain> --from <src> --amount <usdc>	جسر USDC → غاز روما (CCTP) — مسار الدخول "من المنزل"
rome bridge <chain> --from <src> --amount <usdc> [--intent gas|wrapper]	جسر USDC إلى الداخل كغاز أو wUSDC
rome bridge <chain> --to <dest> --amount <usdc>	جسر wUSDC إلى الخارج — الحرق على روما؛ وتطالب به على الوجهة (روما يدعم الوارد، لا مطالبة الصادر)
rome activate <chain>	تمويل PDA لمرة واحدة مطلوب قبل أول جسر صادر (الوارد بلا احتكاك — لا يحتاج شيئًا)
rome verify <chain> [--path …]	الـ بوابة الأعمال الواعية بالمسار، واحدة لكل مسار دخول: solidity — العقد نفسه يستجيب على مسار EVM و مسار سولانا · solana-program — استدعاء على مسار EVM يشغّل برنامج سولانا عبر CPI · من المنزل — جسر دخول → تنفيذ على روما → جسر خروج، وقد ثبتت الرحلة ذهابًا وإيابًا

اربطه بوكيل ذكاء اصطناعي (MCP)

أنت لا تشغّل أو تستضيف أي شيء — عميل MCP لديك يطلق rome mcp (خادم stdio) عند الطلب. سجّله مرة واحدة:

{ "mcpServers": { "rome": { "command": "npx", "args": ["-y", "github:rome-protocol/rome-cli", "mcp"] } } }

(مع تثبيت الاستنساخ + الربط، { "command": "rome", "args": ["mcp"] } يعمل أيضًا — صيغة npx لا تحتاج سوى عدم وجود تثبيت مسبق.)

ثم يستدعي الوكيل أدوات مثل facts_chain, cookbook_cpi_recipe, doctor, tx، و preset — مؤسَّس على السجل الحي + RPC، لذا يتوقف عن تخمين العناوين والمحددات. واجهة MCP هي للقراءة فقط ولا تحتفظ بأي مفاتيح — آمنة للربط بأي وكيل؛ إذ لا يمكنها أبدًا التوقيع أو نقل الأموال. وتبقى إجراءات التوقيع على CLI، مع تزويد المفتاح عبر البيئة.

حلقة تأصيل الوكيل

1. rome cookbook patterns <what I'm building> → أي مستودع أمثلة + أي بنية

2. rome facts chain <chain> → RPC، معرّف البرنامج، رمز الغاز (من دون ترميز صلب)

3. …اكتب الشفرة اعتمادًا على تلك القيم الدقيقة…

4. rome verify <chain> --path <your way in> → أثبت أنه يعمل، أيًّا كان المسار الذي جئت منه

اعرف المزيد

• المستودع + الأدلة الكاملة: rome-protocol/rome-cli

• النظام البيئي والمستودعات · ابنِ تطبيقًا ثنائي المسار · من المنزل: الوصول إلى روما من سلسلة أخرى