内容
[](https://smithery.ai/server/@pixelsock/directus-mcp)
# Directus MCP 服务器
一个 Node.js 服务器,实现 Directus CMS 的模型上下文协议(MCP)。使 AI 客户端能够通过模型上下文协议(MCP)与 [Directus API](https://docs.directus.io/reference/introduction.html) 交互。
<a href="https://glama.ai/mcp/servers/@pixelsock/directus-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@pixelsock/directus-mcp/badge" alt="Directus 服务器 MCP 服务器" />
</a>
## ℹ 前提条件
- [Node.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- [NPM](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- [Directus 实例](https://directus.io/guides/get-started-with-directus-cloud)
## ▶️ 快速开始
1. **获取 Directus API 凭证**
- 进入您的 Directus 实例
- 创建静态访问令牌或获取您的电子邮件和密码
- 安全保存这些凭证
2. **添加到您的 AI 编辑器**
```json
{
"mcpServers": {
"directus": {
"command": "npx",
"args": ["-y", "@pixelsock/directus-mcp@latest"],
"env": {
"DIRECTUS_URL": "https://your-directus-instance.com",
"DIRECTUS_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN"
}
}
}
}
```
或者,您可以使用电子邮件/密码身份验证:
```json
{
"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 设置 → MCP
2. 点击 `+ 添加新的全局 MCP 服务器`
3. 粘贴配置
4. 用您的 Directus 凭证替换占位符值
5. 保存并 **重启** Cursor
**适用于 Claude Desktop:**
1. 打开设置 → 开发者
2. 点击 `编辑配置`
3. 在代码编辑器中打开 `claude_desktop_config.json` 并粘贴配置
4. 用您的 Directus 凭证替换占位符值
5. 保存并 **重启** Claude
## ❓ 故障排除
如果您在使用 MCP 客户端(例如 Cursor 或 Claude Desktop)启动服务器时遇到问题,请尝试以下方法。
### 确保您拥有有效的 Directus 凭证
1. 验证您的 Directus URL 是否正确且可访问
2. 检查您的访问令牌或电子邮件/密码凭证是否有效
3. 在您的 MCP 客户端配置中替换凭证
4. 保存并 **重启** 您的 MCP 客户端
### 确保您已安装 Node 和 NPM
- [Node.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- [NPM](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
运行以下命令以确认您已安装 Node 和 NPM:
```shell
node -v
npm -v
```
### 清除您的 NPM 缓存
有时,清除您的 [NPM 缓存](https://docs.npmjs.com/cli/v8/commands/npm-cache) 可以解决 `npx` 的问题。
```shell
npm cache clean --force
```
## 🛠️ 可用工具
### 集合和项目
```
getItems // 从集合中获取项目
getItem // 通过 ID 从集合中获取单个项目
createItem // 在集合中创建新项目
updateItem // 更新集合中的现有项目
deleteItem // 从集合中删除项目
getCollections // 获取所有集合模式
getFields // 获取集合的字段
getRelations // 获取集合的关系
```
### 文件
```
getFiles // 从 Directus 获取文件
uploadFile // 将文件上传到 Directus
```
### 用户和权限
```
login // 登录 Directus 并获取访问令牌
getUsers // 从 Directus 获取用户
getCurrentUser // 获取当前用户信息
getRoles // 从 Directus 获取角色
getPermissions // 从 Directus 获取权限
```
### 系统
```
getSystemInfo // 从 Directus 获取系统信息
getActivity // 从 Directus 获取活动日志
getConfig // 获取当前配置信息
```
## 🚧 开发模式
如果您想在开发模式下运行服务器:
1. 克隆并安装:
```shell
git clone https://github.com/pixelsock/directus-mcp.git
cd directus-mcp
npm install
```
2. 将您的凭证添加到 `.env`:
```shell
# .env
DIRECTUS_URL=https://your-directus-instance.com
DIRECTUS_ACCESS_TOKEN=your_token_here
# 或使用电子邮件/密码
DIRECTUS_EMAIL=your-email@example.com
DIRECTUS_PASSWORD=your-password
```
3. 启动开发服务器:
```shell
npm run dev
```
## 🌐 HTTP 传输(多用户/远程部署)
默认情况下,服务器使用 `stdio` 传输,这对于单用户本地 AI 编辑器(Cursor、Claude Desktop 等)非常理想。
对于 **多用户** 或 **远程** 环境,您可以通过设置 `MCP_TRANSPORT` 环境变量切换到 [Streamable HTTP 传输](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)。
### 配置
| 环境变量 | 默认值 | 描述 |
| -------------------- | ------------- | -------------------------------------------------------- |
| `MCP_TRANSPORT` | `stdio` | 传输模式:`stdio` 或 `http` / `streamable-http` |
| `MCP_PORT` | `3000` | HTTP 服务器监听的 TCP 端口 |
| `MCP_HOST` | `127.0.0.1` | 绑定主机/接口。使用 `0.0.0.0` 绑定所有接口 |
您还可以通过 CLI 参数传递 `--transport=http` 而不是设置环境变量。
### 运行 HTTP 服务器
```shell
# 通过环境变量
MCP_TRANSPORT=http MCP_PORT=3000 MCP_HOST=0.0.0.0 node dist/index.js
# 通过 CLI 参数
node dist/index.js --transport=http
```
### Docker 示例
```shell
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 传输的客户端:
```json
{
"mcpServers": {
"directus": {
"url": "http://localhost:3000/mcp"
}
}
}
```
## 📄 Directus 开发者资源
- [Directus API 文档](https://docs.directus.io/reference/introduction.html)
- [Directus API 端点](https://docs.directus.io/reference/rest-api.html)
- [Directus JavaScript SDK](https://docs.directus.io/guides/sdk/getting-started.html)