Directus MCP サーバー
Directus CMS用のモデルコンテキストプロトコル（MCP）を実装したNode.jsサーバー。AIクライアントがモデルコンテキストプロトコル（MCP）を介してDirectus APIと対話できるようにします。
ℹ 前提条件
▶️ クイックスタート
- Directus API 認証情報を取得する
- Directusインスタンスに移動する
- 静的アクセストークンを作成するか、メールアドレスとパスワードを取得します
- これらの認証情報を安全に保管してください
- AIエディターに追加する
{
"mcpServers": {
"directus": {
"command": "npx",
"args": ["-y", "@pixelsock/directus-mcp@latest"],
"env": {
"DIRECTUS_URL": "https://your-directus-instance.com",
"DIRECTUS_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN"
}
}
}
}
{
"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 の資格情報に置き換えます
- 保存してクロードを再起動
❓ トラブルシューティング
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 開発者リソース