Directus MCP 서버

Directus CMS용 모델 컨텍스트 프로토콜(MCP)을 구현한 Node.js 서버입니다. AI 클라이언트가 모델 컨텍스트 프로토콜(MCP)을 통해 Directus API 와 상호 작용할 수 있도록 지원합니다.

ℹ 필수 조건

▶️ 빠른 시작

Directus API 자격 증명을 받으세요
- Directus 인스턴스로 이동하세요
- 정적 액세스 토큰을 생성하거나 이메일과 비밀번호를 받으세요
- 이 자격 증명을 안전하게 보관하세요
AI 편집기에 추가지엑스피1또는 이메일/비밀번호 인증을 사용할 수 있습니다.
{ "mcpServers": { "directus": { "command": "npx", "args": ["-y", "@pixelsock/directus-mcp@latest"], "env": { "DIRECTUS_URL": "https://your-directus-instance.com", "DIRECTUS_EMAIL": "your-email@example.com", "DIRECTUS_PASSWORD": "your-password" } } } }
커서의 경우:
1. 설정 → 커서 설정 → MCP로 이동하세요.
2. + Add New Global MCP Server 클릭하세요
3. 구성 붙여넣기
4. 플레이스홀더 값을 Directus 자격 증명으로 바꾸세요.
5. 커서를 저장하고 다시 시작하세요
Claude Desktop의 경우:
1. 설정 → 개발자를 엽니다.
2. Edit Config 클릭하세요
3. 코드 편집기에서 claude_desktop_config.json 열고 구성을 붙여넣습니다.
4. 플레이스홀더 값을 Directus 자격 증명으로 바꾸세요.
5. Claude를 저장하고 다시 시작하세요

❓ 문제 해결

MCP 클라이언트(예: Cursor 또는 Claude Desktop)에서 서버를 시작하는 데 문제가 있는 경우 다음을 시도해 보세요.

유효한 Directus 자격 증명이 있는지 확인하세요

Directus URL이 올바르고 접근 가능한지 확인하세요.
액세스 토큰 또는 이메일/비밀번호 자격 증명이 유효한지 확인하세요.
MCP 클라이언트 구성에서 자격 증명을 교체하세요.
MCP 클라이언트를 저장하고 다시 시작하세요.

Node와 NPM이 설치되어 있는지 확인하세요.

다음 명령을 실행하여 Node와 NPM이 설치되었는지 확인하세요.

node -v
npm -v

NPM 캐시를 지우세요

때로는 NPM 캐시를 지우면 npx 문제가 해결될 수 있습니다.

npm cache clean --force

🛠️ 사용 가능한 도구

컬렉션 및 아이템

getItems                // Get items from a collection
getItem                 // Get a single item from a collection by ID
createItem              // Create a new item in a collection
updateItem              // Update an existing item in a collection
deleteItem              // Delete an item from a collection
getCollections          // Get all collection schemas
getFields               // Get fields for a collection
getRelations            // Get relations for a collection

파일

getFiles                // Get files from Directus
uploadFile              // Upload a file to Directus

사용자 및 권한

login                   // Login to Directus and get an access token
getUsers                // Get users from Directus
getCurrentUser          // Get the current user info
getRoles                // Get roles from Directus
getPermissions          // Get permissions from Directus

체계

getSystemInfo           // Get system information from Directus
getActivity             // Get activity logs from Directus
getConfig               // Get current configuration information

🚧 개발 모드

개발 모드에서 서버를 실행하려면:

복제하고 설치하세요:
git clone https://github.com/pixelsock/directus-mcp.git cd directus-mcp npm install
.env 에 자격 증명을 추가합니다.
# .env DIRECTUS_URL=https://your-directus-instance.com DIRECTUS_ACCESS_TOKEN=your_token_here # Or use email/password DIRECTUS_EMAIL=your-email@example.com DIRECTUS_PASSWORD=your-password
개발 서버 시작:
npm run dev

Directus MCP Server