إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

Gleam

ضمّن خادم StackQL MCP في تطبيق Gleam على الهدف Erlang/BEAM. تتكامل المكتبة مع إشراف OTP، وتقوم بتنزيل الملف الثنائي الموقع رقميًا والتحقق منه، ثم تشغيله عبر stdio.

معلومات

يتم تنزيل الملف الثنائي المضمن والتحقق منه باستخدام sha256 عند التشغيل الأول، أو تضمينه كنسخة محلية في تطبيقك. راجع العقد المشترك.


التثبيت​

gleam add stackql_mcp

تستهدف المكتبة Erlang/BEAM فقط (وليس هدف JavaScript). يتم توفير الخادم كعملية فرعية في OTP عبر child_spec() بحيث يمكن وضعه داخل شجرة الإشراف الخاصة بك.


البدء السريع​

import gleam/io
import gleam/int
import gleam/list
import envoy
import stackql_mcp

pub fn main() {
let config =
stackql_mcp.Config(
..stackql_mcp.default_config(),
auth: [stackql_mcp.auth_for("github", "null_auth")],
)

let assert Ok(server) =
stackql_mcp.start(
config: config,
home: "/home/u",
os: "linux",
arch: "x86_64",
getenv: envoy.get,
)

let assert Ok(tools) = stackql_mcp.list_tools(server)
io.println(int.to_string(list.length(tools)) <> " tools available")

stackql_mcp.stop(server)
}

واجهة API هي stackql_mcp.start() وstop() وchild_spec() لدورة الحياة؛ وlist_tools() وcall_tool() للعمليات (مع الدالتين supervised_list_tools() وsupervised_call_tool() المخصصتين للاستخدام تحت مشرف)؛ وConfig وdefault_config() وauth_for() للتكوين.


الأوضاع​

يتم تعيين الوضع في Config.mode، وقيمته الافتراضية read_only. غيّره إلى safe أو delete_safe أو full_access للتصعيد إلى وضع أعلى:

stackql_mcp.Config(..stackql_mcp.default_config(), mode: stackql_mcp.safe)

التصعيد صريح - لن يمكّن الخادم أدوات تعديل البيانات أو دورة الحياة ما لم تفعّلها اختياريًا.


تضمين نسخة محلية / التضمين​

عند البدء، تقوم المكتبة بتنزيل bundle الخاص بـ StackQL للمنصة، والتحقق منه مقابل قيم sha256 المقفلة المضمنة فيها، وتخزينه مؤقتًا في ذاكرة التخزين المؤقت المشتركة لعائلة المكتبات. أولوية الحل:

  1. القيمة الصريحة لـ Config.binary.
  2. متغير البيئة STACKQL_MCP_BIN.
  3. ذاكرة التخزين المؤقت المشتركة في ~/.stackql/mcp-server-bin/<version>/<platform-key>/.

لعمليات النشر دون اتصال أو المعزولة عن الشبكة، اجعل STACKQL_MCP_BUNDLE يشير إلى bundle محلي.


تطبيق توضيحي​

pipewatch هو التطبيق التوضيحي المخطط له لهذه المكتبة. وهو مدرج في خارطة الطريق ولم يتم تنفيذه بعد.


github.com/stackql/stackql-mcp-gleam