直连式MCP服务器

Name: 直连式MCP服务器
Author: pixelsock

作者：pixelsock20 星标更新：2025-04-24

安装使用来源：spider==github.com

项目介绍

【技术文档摘要】：

Directus MCP 服务器

这是一个基于 Node.js 的服务器，实现了用于 Directus CMS 的模型上下文协议（MCP）。它使AI客户端能够通过模型上下文协议（MCP）与 Directus API 进行交互。

ℹ 先决条件

▶️ 快速开始

获取你的 Directus API 凭据
- 前往你的 Directus 实例
- 创建一个静态访问令牌或获取你的电子邮件和密码
- 保管好这些凭据

添加到你的 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：

前往设置 → Cursor 设置 → MCP
点击 + 添加新的全局 MCP 服务器
粘贴配置
将占位符值替换为你的 Directus 凭据
保存并重启Cursor

对于 Claude Desktop：

打开设置 → 开发者
点击 编辑配置
在代码编辑器中打开 claude_desktop_config.json 并粘贴配置
将占位符值替换为你的 Directus 凭据
保存并重启Claude

❓ 故障排除

如果你在启动 MCP 客户端中的服务器时遇到问题，例如 Cursor 或 Claude Desktop，请尝试以下方法。

确保你有有效的 Directus 凭据

验证你的 Directus URL 是否正确且可访问
检查你的访问令牌或电子邮件/密码凭据是否有效
在你的 MCP 客户端配置中替换凭据
保存并重启你的 MCP 客户端

确保你已安装 Node 和 NPM

Node.js
NPM

运行以下命令以确认你已安装 Node 和 NPM：

node -v
npm -v

清除你的 NPM 缓存

有时清除 NPM 缓存可以解决 npx 的问题。

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               // 获取当前配置信息

🚧 开发模式

如果你想在开发模式下运行服务器：

克隆并安装：

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

将你的凭据添加到 .env：

# .env
DIRECTUS_URL=https://your-directus-instance.com
DIRECTUS_ACCESS_TOKEN=your_token_here
# 或使用电子邮件/密码
DIRECTUS_EMAIL=your-email@example.com
DIRECTUS_PASSWORD=your-password

启动开发服务器：
```
npm run dev
```