基本能力
产品定位
Directus MCP Server 是一个中间件,旨在为AI工具提供与Directus API的无缝连接,使得AI工具能够代表用户执行数据库操作。
核心功能
- 连接Directus API:允许AI工具通过MCP服务器与Directus实例进行交互。
- 自动生成工具:为每个集合自动生成读取工具。
- 用户信息获取:支持获取当前用户的信息。
- 集合信息查询:可以查询系统中可用的集合和字段。
适用场景
- AI工具集成:当AI工具需要访问和操作Directus数据库时。
- 自动化数据处理:在需要自动化读取和处理数据库内容的场景中。
- 开发测试:在开发和测试阶段,快速连接和操作Directus数据库。
工具列表
- Read Items:从集合中读取项目,支持
fields
、sort
和limit
参数。 - Read Current User:获取当前用户的信息,相当于调用
/users/me
端点。 - Read Collections:返回系统中可用的集合和字段信息。
常见问题解答
- 如何配置Claude AI使用此服务器?:在Claude AI的配置中指定MCP服务器的命令和环境变量。
- 支持哪些NodeJS版本?:需要NodeJS v22.12或更高版本。
使用教程
使用依赖
- 确保已安装NodeJS v22.12或更高版本。
安装教程
全局安装(推荐)
bash
npm install -g @rijk/directus-mcp-server
然后配置Claude AI使用此包作为远程服务器:
json
{
"mcpServers": {
"directus": {
"command": "directus-mcp-server",
"env": {
"DIRECTUS_URL": "<your Directus instance URL>",
"DIRECTUS_TOKEN": "<your Directus user token>"
}
}
}
}
本地/开发安装
- 克隆仓库
- 运行以下命令构建服务器:
bash
pnpm install && pnpm build - 配置Claude AI指向
dist
文件:
json
{
"mcpServers": {
"directus": {
"command": "node",
"args": ["/path/to/directus-mcp-server/dist/index.js"]
}
}
}
调试方式
- 确保环境变量
DIRECTUS_URL
和DIRECTUS_TOKEN
已正确设置。 - 运行MCP服务器后,检查Claude AI是否能成功连接并调用工具。