Directus MCP Server

Directus CMS向けのModel Context Protocol (MCP) を実装したNode.jsサーバーです。AIクライアントがDirectus APIとModel Context Protocol (MCP) を通じて対話できるようにします。

ℹ 前提条件

• Node.js

• NPM

• Directusインスタンス

Related MCP server: Node Omnibus MCP Server

▶️ クイックスタート

1. Directus API認証情報を取得する

   • Directusインスタンスにアクセスします

   • 静的アクセストークンを作成するか、メールアドレスとパスワードを取得します

   • これらの認証情報は安全に保管してください

2. 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"
         }
       }
     }
   }

   Cursorの場合：

   1. 設定 → Cursor Settings → MCP に移動します

   2. + Add New Global MCP Server をクリックします

   3. 設定を貼り付けます

   4. プレースホルダーの値をDirectusの認証情報に置き換えます

   5. 保存してCursorを再起動します

   Claude Desktopの場合：

   1. 設定 → Developer に移動します

   2. Edit Config をクリックします

   3. コードエディタで claude_desktop_config.json を開き、設定を貼り付けます

   4. プレースホルダーの値をDirectusの認証情報に置き換えます

   5. 保存してClaudeを再起動します

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

CursorやClaude DesktopなどのMCPクライアントでサーバーの起動に問題がある場合は、以下を試してください。

有効なDirectus認証情報があることを確認する

1. DirectusのURLが正しく、アクセス可能であることを確認します

2. アクセストークンまたはメールアドレス/パスワードの認証情報が有効であることを確認します

3. MCPクライアントの設定で認証情報を置き換えます

4. MCPクライアントを保存して再起動します

NodeとNPMがインストールされていることを確認する

• Node.js

• 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

🚧 開発モード

開発モードでサーバーを実行したい場合：

1. クローンしてインストールします：

   git clone https://github.com/pixelsock/directus-mcp.git
   cd directus-mcp
   npm install

2. .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

3. 開発サーバーを起動します：

   npm run dev

🌐 HTTPトランスポート（マルチユーザー / リモートデプロイメント）

デフォルトでは、サーバーは stdio トランスポートを使用します。これはシングルユーザーのローカルAIエディタ（Cursor、Claude Desktopなど）に最適です。

マルチユーザー環境やリモート環境では、MCP_TRANSPORT 環境変数を設定することで、Streamable HTTPトランスポートに切り替えることができます。

設定

環境変数を設定する代わりに、CLI引数として --transport=http を渡すこともできます。

HTTPサーバーの実行

# Via environment variable
MCP_TRANSPORT=http MCP_PORT=3000 MCP_HOST=0.0.0.0 node dist/index.js

# Via CLI argument
node dist/index.js --transport=http

Dockerの例

docker run -p 3000:3000 \
  -e DIRECTUS_URL=https://your-directus-instance.com \
  -e DIRECTUS_ACCESS_TOKEN=your_token_here \
  -e MCP_TRANSPORT=http \
  -e MCP_HOST=0.0.0.0 \
  ghcr.io/pixelsock/directus-mcp

MCPクライアントをHTTPサーバーに接続する

サーバーが実行されたら、MCPクライアントが以下に接続するように設定します：

http://<host>:<port>/mcp

例えば、Streamable HTTPトランスポートをサポートするクライアントの場合：

{
  "mcpServers": {
    "directus": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

📄 Directus開発者リソース

• Directus APIドキュメント

• Directus APIエンドポイント

• Directus JavaScript SDK