قراءة مو شين | إطلاق النسخة الرسمية من UniSat MCP على npm: إعداد واحد، ويمكن لوكيل الذكاء الاصطناعي الاستعلام عن بيانات سلسلة بتكوين
اليوم في الساعة 11:49، نشر UniSat (@unisat_wallet) خادم MCP @unisat/openapi-mcp على npm، وكانت أول نسخة رسمية هي 1.0.0 مباشرةً. وقبل ذلك بدقيقة، ارتفعت أداة سطر الأوامر @unisat/openapi-cli من الإصدار 0.1.0 الصادر في أغسطس إلى 1.0.0. وحتى الساعة 12:30، لم ينشر الحساب الرسمي لـUniSat على X أي إعلان.
فيما يلي شرح لما يمكن للوكيل الاستعلام عنه، وكيفية ربطه، والعمليات التي تتطلب موافقتك.
🐋 MCP في دقيقة
- MCP معيار لواجهات تتيح لمساعدي الذكاء الاصطناعي استخدام أدوات خارجية، وتدعمه Claude وCursor وCodex. بعد تثبيت خادم MCP، تتوفر للمساعد مجموعة إضافية من الأدوات التي يمكنه استخدامها مباشرةً.
- يعمل خادم UniSat هذا على حاسوبك، ويستخدمه الوكيل لاستدعاء واجهة UniSat Open API. ويمكنه الاستعلام عن شبكة Bitcoin الرئيسية وشبكة Fractal الرئيسية.
- كان الاستعلام عن نقوش عنوان ما أو حاملي عملة BRC-20 يتطلب كتابة الشيفرة واستدعاء الواجهة يدويًا. بعد الربط، يكفي أن تسأل الوكيل باللغة الصينية مباشرةً.
🐋 طريقة الربط
أضف الإعداد التالي إلى إعدادات MCP في عميل مثل Claude أو Cursor:
{
"mcpServers": {
"unisat-ai-kit": {
"command": "npx",
"args": ["-y", "@unisat/openapi-mcp"],
"env": { "UNISAT_BITCOIN_API_KEY": "مفتاحك" }
}
}
}
- يمكنك طلب المفتاح من developer.unisat.io. للاستعلام عن Fractal، عليك طلب مفتاح آخر وإضافته إلى UNISAT_FRACTAL_API_KEY.
- يجب تثبيت Node.js على الحاسوب، بإصدار 22.23.4 أو أحدث (أو إصدار أحدث من 24 أو 26).
- أول اختبار تقترحه الجهة الرسمية: اطلب من الوكيل الاستعلام عن ارتفاع أحدث كتلة في Bitcoin؛ لا تحتاج إلى عنوان أو محفظة.
https://www.npmjs.com/package/@unisat/openapi-mcp
🐋 ما الذي يمكن للوكيل الاستعلام عنه؟
يتيح الخادم للوكيل 4 أدوات فقط:
1. list_operations: البحث عن الواجهات حسب الكلمات المفتاحية، ولا يحتاج هذا الإجراء إلى مفتاح.
2. get_operation: معرفة المعلمات المطلوبة للواجهة وما إذا كانت للقراءة فقط.
3. call_api: استدعاء الواجهة فعليًا.
4. get_status: التحقق من سلامة الخدمة والإعدادات.
يبحث الوكيل بنفسه أولًا، ثم يطّلع على التفاصيل، وأخيرًا يستدعي الواجهة؛ ولا حاجة إلى تثبيت مهارة إضافية. الواجهات التي يمكنه العثور عليها مأخوذة من وثائق الواجهات العامة لـUniSat (الإصدار v2.1.0، المحدّثة في 10/23)، وعددها 308 واجهات موزعة على 18 فئة:
- الكتل والمعاملات وأرصدة العناوين وUTXO
- النقوش وBRC-20 (الحاملون وتقدم الإصدار وسجل المعاملات) وRune وAlkanes
- مبادلة BRC-20، وإدراجات البيع والصفقات في أسواق مجموعات النقوش وBRC-20 وRune وAlkanes وأسماء النطاقات
- أسعار BTC وFB وCAT20، وحجم التداول المتداول في Fractal وترتيب حاملي العملات
مثلًا، تتوفر واجهات للإجابة عن أسئلة مثل «ما عملات BRC-20 الموجودة في هذا العنوان؟» و«من هم أكبر 20 حاملًا لعملة Rune معيّنة؟».
🐋 ما العمليات التي تتطلب موافقتك؟
- من بين الواجهات الـ308، هناك 195 واجهة للقراءة فقط، و113 واجهة تُجري تغييرات: مثل بث المعاملات، وإنشاء النقوش، وإدراج العناصر في السوق وشرائها، والمبادلة وغيرها.
- إذا استدعى الوكيل إحدى هذه الواجهات الـ113 من دون معلمة تأكيد، فسيُرفض الطلب مباشرةً برسالة «يتطلب تفويض المستخدم». وتوضح تعليمات الأداة أنه لا يجوز للوكيل إضافة معلمة التأكيد إلا بعد موافقة المستخدم الصريحة على هذه العملية بعينها.
- لا تتعامل الحزمة مع المفاتيح الخاصة. فالواجهات الخاصة بإدراج العناصر للبيع أو شرائها تُرجع معاملة بانتظار التوقيع، ويجب أن توقّعها في محفظتك قبل إرسالها.
- تتطلب استعلامات القراءة فقط مفتاحًا أيضًا، ويُحتسب حد الاستخدام بحسب المفتاح. ويمكن لـcall_api كذلك التحقق من الرصيد المتبقي للمفتاح الحالي.
🐋 ما سبق هذا الإصدار
- 8/18: نُشر CLI 0.1.0 على npm.
- 10/23: أُضيفت أولًا صفحة بعنوان «OpenAPI CLI & MCP» إلى وثائق المطورين، وتضمنت إعداد npx. في ذلك الوقت، لم يكن بالإمكان العثور على الحزمة على npm. وفي اليوم نفسه، أُرسل إلى مستودع الشيفرة التزام بعنوان «الاستعداد لإصدار v0.1.5».
- 10/30، الساعة 11:47: نُشرت نسخة اختبارية أولًا؛ ثم CLI 1.0.0 في 11:48، وMCP 1.0.0 في 11:49، متجاوزين الإصدار 0.1.5.
——
نُشر هذا المقال أول مرة على X عبر @musinoot
اليوم في الساعة 11:49، نشر UniSat (@unisat_wallet) خادم MCP @unisat/openapi-mcp على npm، وكانت أول نسخة رسمية هي 1.0.0 مباشرةً. وقبل ذلك بدقيقة، ارتفعت أداة سطر الأوامر @unisat/openapi-cli من الإصدار 0.1.0 الصادر في أغسطس إلى 1.0.0. وحتى الساعة 12:30، لم ينشر الحساب الرسمي لـUniSat على X أي إعلان.
فيما يلي شرح لما يمكن للوكيل الاستعلام عنه، وكيفية ربطه، والعمليات التي تتطلب موافقتك.
🐋 MCP في دقيقة
- MCP معيار لواجهات تتيح لمساعدي الذكاء الاصطناعي استخدام أدوات خارجية، وتدعمه Claude وCursor وCodex. بعد تثبيت خادم MCP، تتوفر للمساعد مجموعة إضافية من الأدوات التي يمكنه استخدامها مباشرةً.
- يعمل خادم UniSat هذا على حاسوبك، ويستخدمه الوكيل لاستدعاء واجهة UniSat Open API. ويمكنه الاستعلام عن شبكة Bitcoin الرئيسية وشبكة Fractal الرئيسية.
- كان الاستعلام عن نقوش عنوان ما أو حاملي عملة BRC-20 يتطلب كتابة الشيفرة واستدعاء الواجهة يدويًا. بعد الربط، يكفي أن تسأل الوكيل باللغة الصينية مباشرةً.
🐋 طريقة الربط
أضف الإعداد التالي إلى إعدادات MCP في عميل مثل Claude أو Cursor:
{
"mcpServers": {
"unisat-ai-kit": {
"command": "npx",
"args": ["-y", "@unisat/openapi-mcp"],
"env": { "UNISAT_BITCOIN_API_KEY": "مفتاحك" }
}
}
}
- يمكنك طلب المفتاح من developer.unisat.io. للاستعلام عن Fractal، عليك طلب مفتاح آخر وإضافته إلى UNISAT_FRACTAL_API_KEY.
- يجب تثبيت Node.js على الحاسوب، بإصدار 22.23.4 أو أحدث (أو إصدار أحدث من 24 أو 26).
- أول اختبار تقترحه الجهة الرسمية: اطلب من الوكيل الاستعلام عن ارتفاع أحدث كتلة في Bitcoin؛ لا تحتاج إلى عنوان أو محفظة.
https://www.npmjs.com/package/@unisat/openapi-mcp
🐋 ما الذي يمكن للوكيل الاستعلام عنه؟
يتيح الخادم للوكيل 4 أدوات فقط:
1. list_operations: البحث عن الواجهات حسب الكلمات المفتاحية، ولا يحتاج هذا الإجراء إلى مفتاح.
2. get_operation: معرفة المعلمات المطلوبة للواجهة وما إذا كانت للقراءة فقط.
3. call_api: استدعاء الواجهة فعليًا.
4. get_status: التحقق من سلامة الخدمة والإعدادات.
يبحث الوكيل بنفسه أولًا، ثم يطّلع على التفاصيل، وأخيرًا يستدعي الواجهة؛ ولا حاجة إلى تثبيت مهارة إضافية. الواجهات التي يمكنه العثور عليها مأخوذة من وثائق الواجهات العامة لـUniSat (الإصدار v2.1.0، المحدّثة في 10/23)، وعددها 308 واجهات موزعة على 18 فئة:
- الكتل والمعاملات وأرصدة العناوين وUTXO
- النقوش وBRC-20 (الحاملون وتقدم الإصدار وسجل المعاملات) وRune وAlkanes
- مبادلة BRC-20، وإدراجات البيع والصفقات في أسواق مجموعات النقوش وBRC-20 وRune وAlkanes وأسماء النطاقات
- أسعار BTC وFB وCAT20، وحجم التداول المتداول في Fractal وترتيب حاملي العملات
مثلًا، تتوفر واجهات للإجابة عن أسئلة مثل «ما عملات BRC-20 الموجودة في هذا العنوان؟» و«من هم أكبر 20 حاملًا لعملة Rune معيّنة؟».
🐋 ما العمليات التي تتطلب موافقتك؟
- من بين الواجهات الـ308، هناك 195 واجهة للقراءة فقط، و113 واجهة تُجري تغييرات: مثل بث المعاملات، وإنشاء النقوش، وإدراج العناصر في السوق وشرائها، والمبادلة وغيرها.
- إذا استدعى الوكيل إحدى هذه الواجهات الـ113 من دون معلمة تأكيد، فسيُرفض الطلب مباشرةً برسالة «يتطلب تفويض المستخدم». وتوضح تعليمات الأداة أنه لا يجوز للوكيل إضافة معلمة التأكيد إلا بعد موافقة المستخدم الصريحة على هذه العملية بعينها.
- لا تتعامل الحزمة مع المفاتيح الخاصة. فالواجهات الخاصة بإدراج العناصر للبيع أو شرائها تُرجع معاملة بانتظار التوقيع، ويجب أن توقّعها في محفظتك قبل إرسالها.
- تتطلب استعلامات القراءة فقط مفتاحًا أيضًا، ويُحتسب حد الاستخدام بحسب المفتاح. ويمكن لـcall_api كذلك التحقق من الرصيد المتبقي للمفتاح الحالي.
🐋 ما سبق هذا الإصدار
- 8/18: نُشر CLI 0.1.0 على npm.
- 10/23: أُضيفت أولًا صفحة بعنوان «OpenAPI CLI & MCP» إلى وثائق المطورين، وتضمنت إعداد npx. في ذلك الوقت، لم يكن بالإمكان العثور على الحزمة على npm. وفي اليوم نفسه، أُرسل إلى مستودع الشيفرة التزام بعنوان «الاستعداد لإصدار v0.1.5».
- 10/30، الساعة 11:47: نُشرت نسخة اختبارية أولًا؛ ثم CLI 1.0.0 في 11:48، وMCP 1.0.0 في 11:49، متجاوزين الإصدار 0.1.5.
——
نُشر هذا المقال أول مرة على X عبر @musinoot
