Laravel 艺术家 MCP 服务器

一个允许通过 Claude 和其他 MCP 客户端安全执行 Laravel 艺术家命令的模型上下文协议 (MCP) 服务器。该服务器充当 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 助手）协助开发（他坚持添加此谦逊的感谢，同时承诺不会包含表情符号或过多的热情）。