عن المشروع

academic-tools-mcp هو خادم Model Context Protocol (MCP) مبني على FastMCP يوفر لوكلاء LLM أدوات مركزة للعمل مع الأوراق الأكاديمية. يدعم الاستعلام الموحد عن بيانات الأوراق البحثية، البحث عن المؤلفين، تحميل ملفات PDF كاملة وتحويلها إلى markdown مقسم حسب الأقسام، تتبع مراجع ورسوم بيانية للاقتباسات، والاستشهاد عبر Wikipedia. مصادر البيانات تشمل OpenAlex (بيانات الأوراق والمؤلفين والاقتباسات)، arXiv وbioRxiv/medRxiv (نسخ أولية مع إمكانية الوصول لملفات PDF)، ACL Anthology (أوراق المؤتمرات)، Crossref (قوائم المراجع واكتشاف DOI)، OpenCitations (رسوم اقتباسات)، وWikipedia (ملخصات المقالات). جميع استجابات API يتم تخزينها مؤقتاً محلياً حسب فترة صلاحية محددة لكل مزود، ويتم توحيد المكالمات المتزامنة لنفس الورقة إلى عملية جلب واحدة. تم تخزين نتائج 404 بشكل سلبي لتجنب استنزاف ميزانية الاستخدام. خط الأنابيب PDF يحمل الأوراق ويحولها إلى markdown على مستوى الأقسام باستخدام backends قابلة للتكوين مثل MinerU أو Marker، أو وضع سريع خفيف عبر pdftotext. يُبنى فهرس بحث BM25 على جميع الأوراق المحوّلة لدعم البحث الكامل محلياً. الإعداد يتطلب Python 3.11+ وuv. التكوين عبر متغيرات البيئة في .env. يمكن استخدام الخادم مع Claude Code، أو تشغيله منفصلاً، أو إطلاقه عبر FastMCP CLI.