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"
}
}
}
}
- 설정 → 커서 설정 → MCP로 이동하세요.
+ Add New Global MCP Server 클릭하세요- 구성 붙여넣기
- 플레이스홀더 값을 Directus 자격 증명으로 바꾸세요.
- 커서를 저장하고 다시 시작하세요
Claude Desktop의 경우:
- 설정 → 개발자를 엽니다.
Edit Config 클릭하세요- 코드 편집기에서
claude_desktop_config.json 열고 구성을 붙여넣습니다. - 플레이스홀더 값을 Directus 자격 증명으로 바꾸세요.
- Claude를 저장하고 다시 시작하세요
❓ 문제 해결
MCP 클라이언트(예: Cursor 또는 Claude Desktop)에서 서버를 시작하는 데 문제가 있는 경우 다음을 시도해 보세요.
유효한 Directus 자격 증명이 있는지 확인하세요
- Directus URL이 올바르고 접근 가능한지 확인하세요.
- 액세스 토큰 또는 이메일/비밀번호 자격 증명이 유효한지 확인하세요.
- MCP 클라이언트 구성에서 자격 증명을 교체하세요.
- MCP 클라이언트를 저장하고 다시 시작하세요.
Node와 NPM이 설치되어 있는지 확인하세요.
다음 명령을 실행하여 Node와 NPM이 설치되었는지 확인하세요.
NPM 캐시를 지우세요
때로는 NPM 캐시를 지우면 npx 문제가 해결될 수 있습니다.
🛠️ 사용 가능한 도구
컬렉션 및 아이템
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
- 개발 서버 시작:
📄 Directus 개발자 리소스