Laravel Artisan MCP Server
2025.03.27
1
PythonLaravel开发工具AI集成开发效率
Laravel Artisan MCP Server 是一个模型上下文协议（MCP）服务器，旨在通过Claude和其他MCP客户端安全地执行Laravel Artisan命令。该服务器充当AI助手与本地Laravel应用程序之间的桥梁，允许通过自然语言对话来管理Laravel项目。
View on GitHub
Overview
基本能力
产品定位
Laravel Artisan MCP Server 是一个专为Laravel开发者设计的工具，旨在通过AI助手（如Claude）安全地执行和管理Laravel项目中的Artisan命令。
核心功能
- 访问包含Laravel项目的单个目录
- 自动定位系统上的PHP
- 仅执行白名单中的Artisan命令
- 查看所有可用的Artisan命令
- 设计安全，具有强大的输入验证
适用场景
- Laravel开发者在开发过程中需要通过AI助手执行Artisan命令
- 团队协作中，非技术成员需要通过自然语言与Laravel项目交互
- 自动化Laravel项目的部分管理任务
工具列表
- run_artisan: 执行白名单中的Artisan命令
- 参数:
command(要运行的Artisan命令) - list_all_artisan_commands: 显示Laravel应用程序中所有可用的Artisan命令
常见问题解答
- "ARTISAN_DIRECTORY must be provided in configuration": 检查环境变量是否正确设置，目录是否存在且可访问
- "Artisan not found at: /path/to/artisan": 确认路径指向有效的Laravel项目目录，Artisan文件存在且有执行权限
- "PHP executable not found": 确保PHP已安装且在系统PATH中
使用教程
使用依赖
- Python 3.10或更高版本
- 带有Artisan CLI的Laravel项目
- 已安装PHP并可在PATH中访问
- MCP兼容客户端（如Claude Desktop）
安装教程
- 克隆仓库:
bash git clone https://github.com/diggy/laravel-artisan-mcp.git cd laravel-artisan-mcp - 创建虚拟环境:
bash uv init uv venv source .venv/bin/activate # Windows: .venv\Scripts\activate - 安装依赖:
bash uv add "mcp[cli]"
调试方式
使用MCP Inspector进行测试:
ARTISAN_DIRECTORY="/absolute/path/to/your/laravel/project" WHITELISTED_COMMANDS="route:list,cache:clear,make:controller" uv run mcp dev artisan_mcp_server.py
或使用.env文件:
uv run mcp dev artisan_mcp_server.py --env-file .env
访问http://localhost:5173测试工具。