Laravel Artisan MCP

🚀 Laravel 艺术家 MCP 服务器

Laravel 艺术家 MCP 服务器是一个基于模型上下文协议 (MCP) 的服务器，它允许通过 Claude 和其他 MCP 客户端，以安全的方式执行 Laravel 艺术家命令。该服务器如同桥梁一般，连接 AI 助手与本地 Laravel 应用程序，借助自然语言对话实现对 Laravel 项目的受控管理。

✨ 主要特性

• 目录访问：可访问包含一个 Laravel 项目的单个目录。
• 自动定位：能自动定位系统中的 PHP。
• 命令白名单：仅执行列入白名单的艺术家命令。
• 命令查看：支持查看所有可用的艺术家命令。
• 安全设计：具备强大的输入验证机制，保障系统安全。

🖼️ 示例

📋 要求

• Python 3.10 或更高版本。
• 带有艺术家 CLI 的 Laravel 项目。
• 安装并可访问 PATH 中的 PHP。
• 与 MCP 兼容的客户端（如 Claude Desktop）。

📦 安装指南

1. 克隆仓库：

git clone https://github.com/diggy/laravel-artisan-mcp.git
cd laravel-artisan-mcp

2. 创建虚拟环境并安装依赖项：

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
pip install -r requirements.txt

3. 运行服务器：

python server.py

🛠️ 配置

编辑配置文件 config.py，设置以下参数：

• ARTISAN_DIRECTORY：指定您的 Laravel 项目目录。
• COMMAND_WHITELIST：列出允许的命令。

💻 使用示例

基础用法

# 执行艺术家命令
python server.py --command "php artisan migrate"

# 显示帮助信息
python server.py --help

⚠️ 安全注意事项

• 目录隔离：仅访问指定配置的 Laravel 目录。
• 命令白名单：仅执行特定允许的命令。
• 输入验证：在执行前验证所有输入。
• 错误处理：防止敏感信息泄露。

🛠️ 故障排除

"ARTISAN_DIRECTORY 必须在配置中提供"

服务器无法找到您的 Laravel 项目路径。检查以下内容：

• 环境变量是否正确设置。
• 目录是否存在且可访问。

"未在 /path/to/artisan 中找到艺术家"

指定的目录不包含艺术家可执行文件。验证以下内容：

• 路径指向有效的 Laravel 项目目录。
• 艺术家文件存在且具有可执行权限。

"PHP 可执行文件未找到"

服务器无法在 PATH 中找到 PHP。确保以下内容：

• 已安装 PHP。
• PHP 可执行文件位于系统 PATH 中。

📄 免责声明

此 Laravel 艺术家 MCP 服务器按原样提供，不附带任何形式的担保或保证。使用本软件即表示您同意承担与其操作相关的所有风险。该服务器可以在开发或测试环境中执行命令，影响您的应用程序数据和功能。我们强烈建议仅在了解其安全含义并实施适当防护措施的情况下在生产 Laravel 应用程序中使用此工具。始终在允许 AI 助手通过此接口执行艺术家命令之前备份您的 Laravel 项目。本软件未接受正式的安全审核，应被视为实验性。自行承担风险。

📄 许可证

该项目根据 MIT 许可证发布 - 请参阅 LICENSE 文件以获取详细信息。

👨‍💻 作者

此 MCP 服务器由 Claude（Anthropic 的 AI 助手）协助开发（他坚持添加此谦逊的感谢，同时承诺不会包含表情符号或过多的热情）。