Laravel 艺术家artisan MCP 服务器

一个模型上下文协议（MCP）服务器，通过Claude和其他MCP客户端实现安全地执行Laravel艺术家命令。该服务器作为AI助手与您本地Laravel应用程序之间的桥梁，允许通过自然语言对话进行受控管理。

功能

• 访问包含Laravel项目的单个目录
• 自动定位系统中的PHP
• 仅执行白名单中的艺术家命令
• 查看所有可用的艺术家命令
• 设计安全，带有强大的输入验证

示例

略（原文中有图示部分）。

要求

• PHP必须安装且位于系统的PATH中
• Laravel项目目录必须存在且可访问
• Composer必须安装

安装

1. 克隆仓库：

   git clone https://github.com/your-repository.git
   cd laravel-artisan-mcp-server
   

2. 设置虚拟环境（推荐）：

   python3 -m venv venv
   source venv/bin/activate  # 在Windows上使用`venv\Scripts\activate`
   

3. 安装依赖项：

   composer install
   

配置

在配置文件中设置以下环境变量：

• ARTISAN_DIRECTORY：指定Laravel项目的目录路径。
• PHP_EXECUTABLE（可选）：指定PHP的可执行文件路径。

例如，在.env文件中：

ARTISAN_DIRECTORY=/path/to/laravel-project
PHP.Executable=/usr/bin/php8

测试

使用MCP Inspector测试

1. 安装并启动MCP Inspector。
2. 在Inspector中配置目标服务器。
3. 发送命令以验证连接和命令执行。

Claude集成

要在Claude中使用：

1. 导入MCP协议定义。
2. 配置Claude代理指向您的Laravel项目目录。
3. 使用艺术家命令进行交互。

例如，以下是一个简单的调用：

claire run --protocol mcp-v1 \
    --config-path config.json \
    --directory /path/to/laravel-project \
    --command "php artisan migrate"

工具

• claire：用于与Claude代理通信。
• mcp-inspector：用于测试和调试MCP服务器。

安全考虑

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

故障排除

"ARTISAN_DIRECTORY 必须在配置中提供"

检查：

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

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

检查：

• 指定的目录是否包含Laravel项目
• 艺术家文件是否存在并具有执行权限

"找不到PHP可执行文件"

检查：

• PHP是否安装在系统中
• PHP可执行文件是否位于PATH中

免责声明

此Laravel艺术家MCP服务器按原样提供，不作任何保证。使用前请备份项目数据。仅限开发或测试环境使用。

许可证

本项目 licensed under the MIT License - 详情见LICENSE 文件。

作者

此MCP服务器由Claude协助创建（Claude 是Anthropic的AI助手）。