AdonisJS MCP服务器
安全 模型上下文协议（MCP） 服务器 用于执行AdonisJS Ace命令。该服务器允许AI助手 通过受控的安全界面与AdonisJS项目进行交互。
特性
- 🔒 缺省安全：将危险命令列入黑名单并阻止shell
注射
- 🛠️ 25个专用工具：所有常见AdonisJS的预配置工具
运营
- 📚 内置文档访问：直接获取AdonisJS v7文档
标记语言
- ⏱️ 超时保护：30s超时防止交互式无限挂起
提示
- ✅ 验证：使用Zod模式进行严格的参数验证
- 📦 TypeScript：完全使用TypeScript实现更好的DX
快速开始
这是一个MCP服务器，它作为AI启动的外部进程运行 客户。在MCP客户端设置中配置它：
{
"mcpServers": {
"adonisjs": {
"command": "npx",
"args": ["-y", "@mkrlbs/mcp-adonisjs"]
}
}
}请参阅 文档 用于客户特定指令（VS 代码、克劳德桌面、克劳德代码、反重力、Codex、Gemini CLI等）。
可用工具
脚手架
| 工具 | 命令 | 额外参数 |
|---|---|---|
make_controller | node ace make:controller | resource （布尔值） |
make_service | node ace make:service | — |
make_migration | node ace make:migration | withModel （布尔值， -m 旗帜） |
make_model | node ace make:model | — |
make_validator | node ace make:validator | — |
make_seeder | node ace make:seeder | — |
make_exception | node ace make:exception | — |
make_middleware | node ace make:middleware | — |
make_test | node ace make:test | suite （单元/功能/浏览器） |
make_factory | node ace make:factory | — |
make_policy | node ace make:policy | — |
make_event | node ace make:event | — |
make_listener | node ace make:listener | — |
make_mailer | node ace make:mailer | — |
make_command | node ace make:command | — |
make_repository | _（文件生成）_ | — |
数据库和路由
| 工具 | 命令 | 额外参数 |
|---|---|---|
migration_run | node ace migration:run | force （布尔值） |
migration_rollback | node ace migration:rollback | batch （编号） |
migration_status | node ace migration:status | — |
db_seed | node ace db:seed | files （字符串） |
list_routes | node ace list:routes | — |
文档
| 工具 | 描述 | Args |
|---|---|---|
check_docs | 获取某个主题的AdonisJS v7文档作为markdown | topic （字符串） |
list_docs | 列出可用的文档主题，可按类别筛选 | category （字符串，可选） |
14个类别可供选择： 开始、基础、前端、数据库、身份验证、安全， 概念，深入挖掘，ace，测试，教程超媒体，教程反应， 参考，资源。
效用
| 工具 | 描述 | Args |
|---|---|---|
set_project_cwd | 设置Ace命令的工作目录 | path （字符串） |
run_ace_command | 捕获所有Ace命令 | command （字符串）， args （字符串\[\]） |
所有脚手架工具均接受 name （string，必填）参数。
例子
{ "name": "UserController", "resource": true }{ "name": "create_projects_table", "withModel": true }{ "name": "users/list", "suite": "functional" }{ "command": "make:provider", "args": ["AppProvider"] }{ "topic": "routing" }{ "category": "auth" }安全
列入黑名单的命令
出于安全原因，以下命令被列入黑名单：
migration:fresh
尝试运行这些命令将导致错误。
外壳注射保护
所有命令参数都经过验证，以防止shell注入攻击。这 不允许使用以下字符：
;（分号）&（与）|（管道）- `
$（美元符号）<>（尖括号）\（反斜杠）
超时
所有命令都有30秒的超时时间，以防止交互式系统无限挂起 提示。
发展
建筑
npm run build测试
npm run test观看模式
npm run watch需求
- Node.js 24+
- AdonisJS项目（自动检测或通过设置
set_project_cwd工具）
许可证
麻省理工学院