内容
[!WARNING]
这是一个实验性的 MCP server,用于测试其功能。我们已经在 https://github.com/directus/mcp 上发布了一个官方的 Directus MCP server 🙂
---
# Directus Model Context Protocol (MCP) Server
用于 Directus 的 MCP server。允许你的 AI 工具连接并代表你使用你的 Directus API。
这是由 @rijkvanzanten 做的实验。欢迎提交任何 PR :)
## Installation
这个 MCP server 构建为与 NodeJS v22.12 或更高版本一起使用。
### Global Installation (Recommended)
`npm install -g @rijk/directus-mcp-server`
然后配置 Claude AI 以使用 `npm` 包作为远程服务器:
```json
{
"mcpServers": {
"directus": {
"command": "directus-mcp-server",
"env": {
"DIRECTUS_URL": "<你的 Directus 实例 URL>",
"DIRECTUS_TOKEN": "<你的 Directus 用户 token>"
}
}
}
}
```
### Local / Dev Installation
1. 克隆 repo
2. `pnpm install && pnpm build` 构建服务器
3. 像上面一样配置 Claude AI,但将其指向 `dist` 文件:
```json
{
"mcpServers": {
"directus": {
"command": "node",
"args": ["/path/to/directus-mcp-server/dist/index.js"]
}
}
}
```
## Tools
### Read Items
`read-items` 工具允许你通过提供集合名称作为参数,从任何 Directus 集合中读取条目。
参数:
- `collection`: (必需) 要从中读取的集合的名称
- `fields`: (可选) 要返回的字段名称数组
- `sort`: (可选) 要排序的字段(前缀 `-` 表示降序)
- `limit`: (可选) 要返回的最大条目数
例子:
```json
{
"collection": "articles",
"fields": ["id", "title", "date_published"],
"sort": "-date_published",
"limit": 10
}
```
### Read Current User
获取有关当前用户的信息。实际上是 `/users/me` 端点。
### Read Collections
返回系统中可用的集合/字段。首先使用此工具发现可用的集合,然后再使用 `read-items` 工具。
## License
MIT