Laravel Artisan MCP Server

🚀 Laravel 艺术家artisan MCP 服务器

Laravel 艺术家artisan MCP服务器是一个模型上下文协议（MCP）服务器，它能借助Claude和其他MCP客户端，安全地执行Laravel艺术家命令。该服务器就像一座桥梁，连接着AI助手和您本地的Laravel应用程序，支持通过自然语言对话对应用进行受控管理。

🚀 快速开始

Laravel 艺术家artisan MCP服务器允许通过自然语言对话，在AI助手与本地Laravel应用程序之间实现受控管理。以下是使用前的准备步骤。

✨ 主要特性

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

📦 安装指南

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助手）。