MCP

SQLite MCP: افحص أولًا قاعدة اختبار للقراءة فقط ثم قرر هل تكتب

لمن يريد الاستعلام في SQLite محلي أو كتابة insight memo. المحاولة الأولى تفحص فقط --db-path قابلًا للرمي للقراءة فقط؛ لا تستدعِ write_query أولًا.

Official source · modelcontextprotocol/server-sqlite

Install

uv --directory parent_of_servers_repo/servers/src/sqlite run mcp-server-sqlite --db-path ~/test.db

لمن يناسب

يناسب من يريد تشغيل SQL على ملف SQLite محلي، ورؤية بيانات أعمال، وترك insight memo. الأدلة تنص: يوفّر هذا MCP تفاعل قاعدة وذكاء أعمال عبر SQLite؛ يمكنه تنفيذ SQL وتحليل بيانات الأعمال وتوليد مذكرات بصيرة تلقائيًا.

يجب أن تقدّم ملف SQLite الذي يشير إليه --db-path، وأن تقبل أن العملية ستقرأه وقد تغيّره. المثال الرسمي هو ~/test.db. لا تستخدم قاعدة إنتاج في المحاولة الأولى.

تقع الصفحة تحت servers-archived. الأدلة لا تكتب حالة الصيانة ولا قائمة عملاء على حدة؛ الغطاء يتوقف عند: تستطيع تشغيل mcp-server-sqlite بـ uv في ذلك المجلد.

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

اتبع مسار uv الرئيسي؛ لا تجعل Docker التثبيت الرئيسي. في العميل اضبط:

"command": "uv",
"args": [
  "--directory",
  "parent_of_servers_repo/servers/src/sqlite",
  "run",
  "mcp-server-sqlite",
  "--db-path",
  "~/test.db"
]

استبدل --directory بمسار محلي حقيقي و--db-path بقاعدة اختبار قابلة للرمي.

الشروط المسبقة: uv مثبت؛ يحق لك إنشاء قاعدة الاختبار أو فتحها. هذا يصل إلى ملفات محلية؛ ليست صندوق رمل بلا قراءات محلية.

موضع الإعداد: command / args لـ MCP في العميل.

أول استدعاء منخفض المخاطر: افحص أولًا دون تغيير الجداول—استخدم «تشغيل استعلامات SQL / تحليل بيانات الأعمال» من بيان الهوية لرؤية المحتوى الموجود، أو اقرأ فقط المورد memo://insights. الأدلة تنص أن هناك ست أدوات أساسية، لكن ذلك المحدد لا يسرد أسماء أدوات القراءة فقط ومعاملاتها. لا تستدعِ أولًا write_query الموسَّع بالكامل: ينفّذ INSERT أو UPDATE أو DELETE ويعيد { affected_rows: number }. ولا تشغّل أولًا append-insight الذي يغيّر المذكرة.

إشارة النجاح: بعد إقلاع الخادم تحصل على نتيجة استعلام على قاعدة الاختبار، أو تقرأ المحتوى الحالي لـ memo://insights. إن لم تُقلع العملية فافحص أولًا uv والمجلد؛ لا تنتقل إلى Docker.

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

الحالة 1: انظر مرة إلى بيانات الأعمال على قاعدة الاختبار. نفّذ استعلام SQL أو تحليلًا وفق دليل الهوية. توقيعات القراءة فقط للأدوات الست غير موسَّعة في المحدد؛ قف عند «يمكنك الاستعلام/التحليل في القاعدة التي يشير إليها --db-path» ولا تخترع أسماء أدوات أو معاملات تصفية.

الحالة 2: اقرأ insight memo وقرر هل تضيف. يجمع المورد memo://insights باستمرار الرؤى المكتشفة أثناء التحليل ويتحدّث تلقائيًا عند تشغيل append-insight. اقرأ ذلك المورد أولًا. الإضافة تغيّر المذكرة؛ الأدلة بلا تراجع ولا تكتب معاملات. لا تستدعِ إلا بعد قبول إعادة الكتابة ومرور نقطة تأكيد. يغيّر write_query بيانات الجدول—أثر جانبي مختلف عن المذكرة؛ لا تستخدمه في هذه الحالة.

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

المسار الرئيسي هو uv run mcp-server-sqlite --db-path <file>. مثال Docker هو docker run --rm -i -v mcp-test:/mcp mcp/sqlite --db-path /mcp/test.db؛ لا تجعله المسار الرئيسي. يغيّر write_query صفوفًا بلا تراجع رسمي. يحدّث append-insight المورد memo://insights. باستثناء write_query وappend-insight فإن معظم أسماء ومعاملات الأدوات الست غير موسَّعة في المحدد. الوصول إلى ملفات محلية وكتابة القاعدة ليسا بلا مخاطر. الأدلة لا تكتب نسخًا احتياطيًا ولا تراجع معاملة ولا بديلًا بعد الأرشفة.