Directus Model Context Protocol (MCP) Server

基本能力

产品定位

Directus MCP Server 是一个中间件，旨在为AI工具提供与Directus API的无缝连接，使得AI工具能够代表用户执行数据库操作。

核心功能

• 连接Directus API：允许AI工具通过MCP服务器与Directus实例进行交互。
• 自动生成工具：为每个集合自动生成读取工具。
• 用户信息获取：支持获取当前用户的信息。
• 集合信息查询：可以查询系统中可用的集合和字段。

适用场景

• AI工具集成：当AI工具需要访问和操作Directus数据库时。
• 自动化数据处理：在需要自动化读取和处理数据库内容的场景中。
• 开发测试：在开发和测试阶段，快速连接和操作Directus数据库。

工具列表

1. Read Items：从集合中读取项目，支持fields、sort和limit参数。
2. Read Current User：获取当前用户的信息，相当于调用/users/me端点。
3. Read Collections：返回系统中可用的集合和字段信息。

常见问题解答

• 如何配置Claude AI使用此服务器？：在Claude AI的配置中指定MCP服务器的命令和环境变量。
• 支持哪些NodeJS版本？：需要NodeJS v22.12或更高版本。

使用教程

使用依赖

• 确保已安装NodeJS v22.12或更高版本。

安装教程

全局安装（推荐）

npm install -g @rijk/directus-mcp-server

然后配置Claude AI使用此包作为远程服务器：

{
    "mcpServers": {
        "directus": {
            "command": "directus-mcp-server",
            "env": {
                "DIRECTUS_URL": "<your Directus instance URL>",
                "DIRECTUS_TOKEN": "<your Directus user token>"
            }
        }
    }
}

本地/开发安装

1. 克隆仓库
2. 运行以下命令构建服务器：

pnpm install && pnpm build

1. 配置Claude AI指向dist文件：

{
    "mcpServers": {
        "directus": {
            "command": "node",
            "args": ["/path/to/directus-mcp-server/dist/index.js"]
        }
    }
}

调试方式

• 确保环境变量DIRECTUS_URL和DIRECTUS_TOKEN已正确设置。
• 运行MCP服务器后，检查Claude AI是否能成功连接并调用工具。

许可证

该项目遵循 MIT 开源许可条款。