How directus/directus works
Directus is a collaborative backend that exposes existing SQL data through generated REST and GraphQL APIs, alongside a visual management Studio and AI/MCP access. The principal workflow is a user or agent accessing live data through an API or Studio, governed by policy-based permissions and backed by the configured database. The graph preserves documented extension and file-storage capabilities. README statements support the broad product relationships; sampled source confirms schema/database and extension-manager details, but many endpoint-to-service connections were not shown.
Main entry points: items.ts REST API · graphql.ts GraphQL API · server.ts MCP server · fetch-permissions.ts Policy access
Components 20
API Runtime
- REST API
api/src/controllers/items.ts - GraphQL API
api/src/controllers/graphql.ts - Policy access
api/src/permissions/lib/fetch-permissions.ts
Data Platform
- Schema discovery
api/src/utils/get-schema.ts - Database runtime
api/src/database/index.ts - Item services
api/src/services/items.ts - Collection services
api/src/services/collections.ts - Field services
api/src/services/fields.ts - Relation services
api/src/services/relations.ts - Data import
api/src/services/import/import.ts - File storage
api/src/services/files.ts
Management Studio
- Visual Studio
app/src/app.vue
AI Access
- AI assistant
api/src/ai/chat/controllers/chat.post.ts - MCP server
api/src/ai/mcp/server.ts - AI data tools
api/src/ai/tools/registry.ts
Extensibility
- Extension manager
api/src/extensions/manager.ts - Extension installation
api/src/extensions/lib/installation/manager.ts
Other components
- Builder or teammate
- AI agent
- SQL database
Connections 19
- Builder or teammate → Visual Studio: manages data
- Visual Studio → REST API: accesses live data
- Builder or teammate → REST API: requests data
- Builder or teammate → GraphQL API: queries data
- AI agent → MCP server: connects to
- MCP server → Policy access: enforces policies
- REST API → Policy access: governed by
- GraphQL API → Policy access: governed by
- Schema discovery → Database runtime: inspects schema
api/src/utils/get-schema.ts - Schema discovery → Relation services: reads relations
api/src/utils/get-schema.ts - Database runtime → SQL database: connects to
- REST API → Item services: serves item access
- GraphQL API → Item services: serves item access
- MCP server → AI data tools: uses tools
- AI data tools → Item services: acts on data
- Builder or teammate → Data import: imports data
- Builder or teammate → File storage: manages files
- Builder or teammate → Extension manager: extends platform
- Extension manager → Extension installation: installs extensions
api/src/extensions/manager.ts