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" } } } }
カーソルの場合:
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. 保存してクロードを再起動

❓ トラブルシューティング

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