Laravel Herd MCP

laravel牛群mcp

218 MCP工具 --让克劳德完全控制你的 Laravel羊群 Windows上的开发环境。

](https://www.npmjs.com/package/laravel-herd-mcp)    

______________________________________________________________________

这是什么？

laravel-herd-mcp 将Claude Desktop（或任何MCP客户端）连接到本地Laravel Herd安装。配置后，您可以通过自然语言管理整个PHP开发环境，无需终端。

"Create a new Laravel project called blog, park it, secure it with HTTPS, and isolate it to PHP 8.3"
"Show me failed queue jobs and retry them all"
"Run the database migrations and seed the users table"
"Which sites are running? Switch my-app to PHP 8.2 and restart Herd"
"Install Laravel Telescope and clear its entries older than 24 hours"
"Enable the queries and events watchers in Herd"

此服务器补充了Herd的内置 herd-mcp.phar 通过添加 HTTP/SSE传输，满 CLI工具覆盖率、工匠命令、作曲家管理、调试工具等。

______________________________________________________________________

特性

• 218 MCP工具 跨越20个类别-- 查看完整列表→
• 多IDE --Claude Desktop、Claude Code、VS Code（复制/继续）、Cursor、Windsurf、PhpStorm和任何兼容MCP的客户端
• 跨平台 --Windows和macOS都支持；在两者上都自动检测到羊群路径
• 双重运输 --stdio用于本地客户端，HTTP/SSE用于远程或多客户端设置
• 自动检测 您的Herd安装，无需手动配置路径
• 牛群自由+专业 --所有仅限Pro的功能都会优雅地降级，并显示清晰的信息
• 非ASCII路径 --即使您的Windows用户名包含西里尔字母或其他非ASCII字符，也能正常工作
• 结构化输出 -从Herd API中清除JSON，从CLI输出中剥离ANSI代码

______________________________________________________________________

需求

| | | |--|--| | Laravel羊群 |Windows版v1.27+·macOS版v1.0+| |Node.js | 18+| |MCP客户端| 克劳德桌面 或任何MCP兼容客户端|

macOS： 完全支持。Laravel Herd将其配置存储在 ~/.config/herd/ 和 ~/Library/Application Support/Herd/ --两条路径都是自动检测的。

______________________________________________________________________

安装

选项A-npx（无需安装）

npx laravel-herd-mcp

选项B——全局安装

npm install -g laravel-herd-mcp
laravel-herd-mcp

选项C——从源代码本地构建

git clone https://github.com/movinginfo/laravel-herd-mcp
cd laravel-herd-mcp
npm install && npm run build
node dist/index.js

______________________________________________________________________

设置

自动安装程序（所有IDE在一个命令中）

自动检测并配置每个支持的IDE：

node install-mcp-wizard/install.js

向导检测Claude Desktop、Claude Code、VS Code、Cursor、Windsurf、Zed、Codex CLI、Antigravity和PhpStorm——备份现有配置并合并MCP条目。

# Options:
node install-mcp-wizard/install.js --yes      # skip confirmation
node install-mcp-wizard/install.js --list     # show detected IDEs only
node install-mcp-wizard/install.js --dry-run  # preview changes, write nothing

📄 完整的IDE指令→ 安装mcp向导/README.md

______________________________________________________________________

克劳德桌面

编辑 %APPDATA%\Claude\claude_desktop_config.json （Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "laravel-herd": {
      "command": "npx",
      "args": ["-y", "laravel-herd-mcp"]
    }
  }
}

重新启动克劳德桌面。

克劳德代码

claude mcp add laravel-herd -- npx -y laravel-herd-mcp

或编辑 ~/.claude/settings.json 直接与相同 mcpServers 块上面。

VS代码

需要 VS代码1.99+ 和那个 GitHub Copilot 扩展。

1--安装副驾驶： Ctrl+Shift+X → 搜索 GitHub Copilot → 安装→ 登录。

2--启用代理模式： Ctrl+, → 搜索 chat.agent.enabled → 勾选复选框。

3--打开 settings.json:

• Ctrl+Shift+P → Preferences: Open User Settings (JSON) *（包括 Preferences: 前缀）*
• 或直接导航：

- 窗户： %APPDATA%\Code\User\settings.json - macOS： ~/Library/Application Support/Code/User/settings.json - Linux： ~/.config/Code/User/settings.json

4--添加MCP块 （合并--不要替换整个文件）：

{
  "mcp": {
    "servers": {
      "laravel-herd": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "laravel-herd-mcp"]
      }
    }
  }
}

5--重新加载： Ctrl+Shift+P → 开发者：重新加载窗口

6--验证： Ctrl+Alt+I → 副驾驶聊天→ 代理 tab → 工具 图标(🔌) → laravel-herd 应该出现。

7-MCP服务器面板选项卡 *（配置/详细信息/清单）*

VS Code启动MCP服务器 懒洋洋地 --它只在第一次工具调用时连接。在此之前，面板仅显示 配置 选项卡。

• 配置 --始终可见（您的settings.json代码段）
• 详情 --出现在第一个连接之后：服务器名称 Laravel Herd，版本，描述，主页
• 清单 --出现在第一个连接之后：所有218个具有名称和描述的工具

要立即解锁详细信息+清单：打开副驾驶聊天→ 代理模式→ 使用任何 laravel-herd 工具（例如。 *“列出畜群站点”*) → 接受权限提示→ 返回MCP面板。

替代方案——SSE模式（所有选项卡立即可见，无需使用工具）

# Step 1: start the server persistently (add to startup / Task Scheduler)
npx laravel-herd-mcp --http --port 3333

// Step 2: use SSE transport in settings.json instead of stdio
{
  "mcp": {
    "servers": {
      "laravel-herd": {
        "type": "sse",
        "url": "http://localhost:3333/sse"
      }
    }
  }
}

VS Code在启动时连接到SSE端点——所有三个选项卡都会立即填充。

光标

创建或编辑 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "laravel-herd": {
      "command": "npx",
      "args": ["-y", "laravel-herd-mcp"]
    }
  }
}

重新启动游标→ check 光标设置→ MCP.

风帆冲浪（Codeium）

创建或编辑 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "laravel-herd": {
      "command": "npx",
      "args": ["-y", "laravel-herd-mcp"]
    }
  }
}

泽德

编辑 ~/.config/zed/settings.json:

{
  "context_servers": {
    "laravel-herd": {
      "command": {
        "path": "npx",
        "args": ["-y", "laravel-herd-mcp"]
      }
    }
  }
}

OpenAI Codex命令行界面

附加 ~/.codex/config.toml:

[[mcp_servers]]
name = "laravel-herd"
command = "npx"
args = ["-y", "laravel-herd-mcp"]

反重力

编辑 %USERPROFILE%\.gemini\antigravity\mcp_config.json （macOS： ~/.gemini/antigravity/mcp_config.json).

合并 laravel-herd 进入现有 mcpServers object--不要添加第二个 {...} 块：

{
  "mcpServers": {
    "context7": {
      "serverUrl": "https://mcp.context7.com/mcp",
      "headers": { "CONTEXT7_API_KEY": "your-key" }
    },
    "laravel-herd": {
      "command": "npx",
      "args": ["-y", "laravel-herd-mcp"]
    }
  }
}

PhpStorm/JetBrains集成开发环境

1. 打开 设置 (Ctrl+Alt+S)
2. 导航至 工具→ AI助手→ 模型上下文协议（MCP）
3. 点击 + → AS流程
4. 命令： npx — 论据： -y laravel-herd-mcp
5. 点击 应用 → 重新启动IDE

看 install-mcp-wizard/configs/phpstorm.xml 对于XML代码段。

其他MCP客户端

任何支持MCP stdio传输的客户端：

{
  "command": "npx",
  "args": ["-y", "laravel-herd-mcp"]
}

检查客户的文档，了解配置文件的位置和格式。 看 install-mcp-wizard/configs/generic.json.

自定义畜群路径

如果Herd安装在非默认位置，请通过 HERD_PATH:

{
  "mcpServers": {
    "laravel-herd": {
      "command": "npx",
      "args": ["laravel-herd-mcp"],
      "env": {
        "HERD_PATH": "C:\\Users\\YourUser\\.config\\herd\\bin"
      }
    }
  }
}

自动配置（使用工具本身）

跑完之后，让克劳德跑 setup_integrations --它将把正确的配置写入Claude Desktop、Claude Code和Herd的 integrations.json 自动。

______________________________________________________________________

HTTP/SSE模式

作为持久HTTP服务器运行，用于多客户端或自定义集成：

npx laravel-herd-mcp --http --port 3333

将您的MCP客户端连接到 http://localhost:3333/sse.

______________________________________________________________________

可用工具

218工具 单独 laravel-herd MCP服务器。 📄 完整工具参考→ tools.md

______________________________________________________________________

配置

环境变量

命令行标志

羊群路径自动检测指令

1. --herd-path CLI标志
2. HERD_PATH 环境变量
3. %USERPROFILE%\.config\herd\bin\herd.bat
4. herd.bat 系统上 PATH

______________________________________________________________________

Git Bash/MINGW

将这些别名添加到 ~/.bash_profile:

alias php="php.bat"
alias herd="herd.bat"
alias laravel="laravel.bat"
alias composer="composer.bat"

______________________________________________________________________

运作原理

laravel-herd-mcp 通过两个渠道与Herd交谈：

Claude ──► laravel-herd-mcp ──► Herd HTTP API (127.0.0.1:9001)   — structured JSON
                             └──► PHP CLI (php.exe herd.phar …)   — park, link, proxy, share…
                             └──► php artisan                     — migrate, queue, cache…
                             └──► composer                        — require, install, update…
                             └──► Herd config.json                — dumps, watchers, settings
                             └──► Native DB drivers               — mysql2, pg, better-sqlite3
                             └──► storage/debugbar/*.json         — Debugbar request profiling
                             └──► telescope_entries DB table      — Telescope watcher data
                             └──► pulse_* DB tables              — Pulse performance metrics

非ASCII路径修复： herd.bat 呼叫裸 php 当Windows用户配置文件路径包含非ASCII字符（例如西里尔字母）时，它会中断。此程序包绕过 herd.bat 完全和呼叫 php.exe herd.phar 直接解析Herd自己的PHP可执行文件 config.json.

______________________________________________________________________

与herd-mcp.har的比较

Laravel Herd内置了一个 herd-mcp.phar （仅PHP、stdio）。 laravel-herd-mcp 扩展和补充它：

______________________________________________________________________

羊群UI修补(patch_herd_ui)

从v0.1.22开始，您不再需要 patch_herd_ui.

这 patch_herd_ui 工具修补Herd's app.asar 添加a *克劳德代码* 集成选项卡中的行。在早期版本中，这是使MCP条目在Herd的UI中可见所必需的。自v0.1.22以来：

• 这 setup_integrations 该工具直接将正确的配置写入Claude Desktop和Claude Code，无需进行UI修补。
• Herd自己的集成支持得到了改进，无需修补即可看到该条目。

patch_herd_ui 保存在插件中 仅用于教育目的 --它展示了电子 app.asar 文件可以被提取和重新打包。不要在生产Herd安装上运行它，因为每次Herd更新后都必须重新应用它。

______________________________________________________________________

贡献

欢迎投稿！打开问题或拉取请求。

git clone https://github.com/movinginfo/laravel-herd-mcp
cd laravel-herd-mcp
npm install
npm run build
node dist/index.js

______________________________________________________________________

许可证

麻省理工学院——见 许可证

______________________________________________________________________

相关

这个项目

核心

支持的AI客户端

集成Laravel包

Node.js驱动程序（直接访问数据库）

传输和模式