Claude Code 在 Laravel 不在根目錄的情況下 Laravel Boost MCP 配置

問題描述

簡單直接地安裝 Laravel Boost 很輕易使用，但我習慣在Project-root目錄中建立docs、design、agents等不同目錄再加上 Laravel 目錄，以前會直接打開 Laravel 目錄直接執行，不過現在常常用到AI協助開發，由其是標題提到的Claude Code

我希望在 Project-root 執行 claude，一直都是這樣的，這樣 Claude 就會知道我的所有一切的開發文檔、開發要求等等，但是問題是 Laravel Boost 雖是mcp 但安裝是需要用 composer 安裝，所以會安裝了去一級子目錄 Laravel目錄中，下面我們假設Laravel 目錄叫web

如果上面這樣的目錄架構，在根目錄去執行claude 再執行/mcp 會發現 Larave-boost報錯無法使用

專案結構

project-root/               ← Claude Code 工作目錄
├── .mcp.json              ← 核心配置文件
├── web/                   ← Laravel 專案
│   ├── artisan
│   └── vendor/
└── docs/

解決方案

1. 確認環境

# 檢查 Laravel Boost 安裝
composer show | grep boost

# 獲取 PHP 完整路徑（重要！）
which php

2. 創建 MCP 配置

在專案根目錄創建 .mcp.json：

{
  "mcpServers": {
    "laravel-boost": {
      "command": "/完整/php/路徑",   
      "args": ["./web/artisan", "boost:mcp"]
    }
  }
}

Herd 用戶範例：

{
  "mcpServers": {
    "laravel-boost": {
      "command": "/Users/username/Library/Application Support/Herd/bin/php",
      "args": ["./web/artisan", "boost:mcp"]
    }
  }
}

3. 重啟驗證

# 重啟 Claude Code
claude code

# 驗證連接
claude mcp list
# 預期輸出：laravel-boost: ... - ✓ Connected

關鍵要點

配置項	正確做法	錯誤做法
PHP 路徑	完整絕對路徑	`php`
Artisan 路徑	`./web/artisan`	`artisan`
配置位置	專案根目錄	Laravel 目錄

常見錯誤

"Could not open input file: artisan"

原因：路徑錯誤
解決：使用 ./web/artisan

"php: command not found"

原因：PHP 路徑不完整
解決：執行 which php 獲取完整路徑

故障排除

查看詳細日誌：

claude --debug
# 或直接查看日誌文件
ls ~/Library/Caches/claude-cli-nodejs/*/mcp-logs-laravel-boost/

總結

多層目錄結構下的 Laravel Boost MCP 配置核心是路徑問題。使用完整 PHP 路徑和正確的相對 artisan 路徑是成功的關鍵。配置文件應放在 Claude Code 的工作目錄，而非 Laravel 專案目錄。