@encryptosystem/mcp-django

@encryptosystem/mcp-django

A reusable, MCP-compatible SDK that connects to a Django REST API to orchestrate inventory automations from n8n or any Model Context Protocol client. The package exposes a Fastify-based MCP server with real-time SSE streams and modular tools for managing company products.

Features

• 🔌 Django-native MCP server powered by Fastify with automatic CORS headers and SSE endpoints.
• 🧰 Reusable tool library for creating, listing, updating, and deleting products.
• ⚙️ Configurable via environment variables with first-class support for .env files.
• 🚀 n8n-ready npm package that can be executed directly with npx @encryptosystem/mcp-django.
• 📦 TypeScript source compiled with tsup to ship ESM output and generated type definitions.

Installation

npm install @encryptosystem/mcp-django

Local development

Clone the repository and install dependencies:

npm install

Configuration

Create a .env file or provide the following environment variables before running the server:

API_BASE_URL=https://api.encryptosystem.com/api
AUTH_BEARER_TOKEN=your-admin-bearer-token

API_TIMEOUT=30000
PORT=3000

Variable	Description
API_BASE_URL	Base URL for the Django REST API (no trailing slash required).
AUTH_BEARER_TOKEN	Bearer token for authenticating requests.

Development server

Run the TypeScript entry point with hot reloading using tsx:

npm run dev

Build for distribution

Compile the package to dist/ with bundled type definitions:

npm run build

NPX runner

Execute the published package without installing it globally:

npx @encryptosystem/mcp-django          # Starts the Fastify MCP server
npx @encryptosystem/mcp-django start    # Explicit start command
npx @encryptosystem/mcp-django list-tools

The CLI prints the registered endpoints and available tools after startup. Use list-tools to confirm the exported toolset before automating workflows.

Publishing workflow

خطوات النشر على npm:

• تسجيل الدخول إلى npm:

  npm login
  

• زيادة رقم الإصدار:

  npm version patch  # أو minor أو major
  

• نشر الحزمة:

  npm publish --access public
  

• التحقق من النشر:

  npx @encryptosystem/mcp-django list-tools
  

استخدام الحزمة في n8n:

راجع ملف N8N_INTEGRATION_GUIDE.md للحصول على دليل شامل لاستخدام الحزمة في n8n.

أمثلة سريعة:

# تشغيل الخادم
npx @encryptosystem/mcp-django

# عرض الأدوات المتاحة
npx @encryptosystem/mcp-django list-tools

# اختبار الاتصال
curl http://localhost:3000/health

License

MIT © Encryptosystem