توثيق API - MD-2-PDF v2.0

نظرة عامة

MD-2-PDF هي أداة لتحويل نصوص Markdown إلى ملفات PDF مع دعم كامل للغة العربية (RTL).

الرابط الأساسي: http://localhost:3000/api

تنسيق الطلبات: JSON مع Content-Type: application/json

المصادقة

معظم نقاط النهاية تعمل بدون مصادقة. لحفظ السجلات، يمكنك:

• تسجيل الدخول: إرسال JWT token عبر Authorization: Bearer <token>
• ضيف: إرسال معرف الجلسة عبر X-Guest-Session: <id>

GET /api/health GET

فحص صحة الخادم والتحقق من أنه يعمل.

مثال الطلب

curl http://localhost:3000/api/health

مثال الاستجابة

{
  "status": "ok",
  "service": "md-2-pdf",
  "version": "2.0.0",
  "timestamp": "2026-01-01T00:00:00.000Z"
}

POST /api/convert POST

تحويل نص Markdown إلى ملف PDF. يعيد الملف مباشرة كـ application/pdf.

المعاملات

مثال الطلب

curl -X POST http://localhost:3000/api/convert \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# مرحباً بالعالم\nهذا **نص** تجريبي.", "options": {"title": "مستندي"}}' \
  --output output.pdf

POST /api/convert/base64 POST

تحويل Markdown إلى PDF مع إرجاعه كـ base64 في JSON.

مثال الاستجابة

{
  "success": true,
  "message": "Conversion successful",
  "metadata": { "title": "...", "createdAt": "..." },
  "pdfBase64": "JVBERi0xLjQK..."
}

POST /api/convert/file POST

تحويل Markdown وحفظ PDF على الخادم. يُعيد مسار الملف المحفوظ.

المعاملات الإضافية

مثال الاستجابة

{
  "success": true,
  "message": "PDF saved successfully",
  "outputPath": "/path/to/output/doc-xxx.pdf"
}

POST /api/parse POST

تحليل Markdown واستخراج البيانات الوصفية مع معاينة HTML.

مثال الطلب

curl -X POST http://localhost:3000/api/parse \
  -H "Content-Type: application/json" \
  -d '{"markdown": "---\ntitle: مستندي\nauthor: أحمد\n---\n# مرحباً"}'

GET /api/history GET

جلب سجلات المستندات المحفوظة. يتطلب مصادقة (JWT أو Guest Session).

المعاملات (Query)

أدوات MCP المتاحة

خادم MCP يوفر الأدوات التالية للذكاء الاصطناعي:

التشغيل عبر أدوات الذكاء الاصطناعي

إعدادات MCP الجاهزة لكل أداة. انسخ الإعداد المناسب وأضفه لملف إعدادات الأداة.

{
  "mcpServers": {
    "md-2-pdf": {
      "command": "node",
      "args": ["C:/Users/Abdalgani/Desktop/myapp/md-2-pdf/dist/mcp/server.js"]
    }
  }
}

# عبر الأمر
claude mcp add md-2-pdf -- node C:/Users/Abdalgani/Desktop/myapp/md-2-pdf/dist/mcp/server.js

# أو في ملف الإعدادات ~/.config/claude/mcp.json
{
  "mcpServers": {
    "md-2-pdf": {
      "command": "node",
      "args": ["C:/Users/Abdalgani/Desktop/myapp/md-2-pdf/dist/mcp/server.js"]
    }
  }
}

{
  "mcpServers": {
    "md-2-pdf": {
      "command": "node",
      "args": ["C:/Users/Abdalgani/Desktop/myapp/md-2-pdf/dist/mcp/server.js"]
    }
  }
}

{
  "mcp": {
    "md-2-pdf": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/Users/Abdalgani/Desktop/myapp/md-2-pdf/dist/mcp/server.js"]
    }
  }
}

{
  "mcp": {
    "md-2-pdf": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/Users/Abdalgani/Desktop/myapp/md-2-pdf/dist/mcp/server.js"]
    }
  }
}

[mcp_servers.md-2-pdf]
command = "node"
args = ["C:/Users/Abdalgani/Desktop/myapp/md-2-pdf/dist/mcp/server.js"]

{
  "mcpServers": {
    "md-2-pdf": {
      "command": "node",
      "args": ["C:/Users/Abdalgani/Desktop/myapp/md-2-pdf/dist/mcp/server.js"]
    }
  }
}

{
  "command": "node",
  "args": ["C:/Users/Abdalgani/Desktop/myapp/md-2-pdf/dist/mcp/server.js"],
  "transport": "stdio"
}