laravel/mcp控制台命令全解析mcp:server:make、mcp:start与Inspector调优调试技巧【免费下载链接】mcpRapidly build MCP servers for your Laravel applications.项目地址: https://gitcode.com/gh_mirrors/mcp62/mcplaravel/mcp 是 Laravel 官方出品的 MCP 服务器构建工具包让开发者可以快速为 Laravel 应用构建 MCP Server使 AI 客户端通过 Model Context Protocol 与你的应用交互。本文聚焦它的 6 个 Artisan 控制台命令make:mcp-server、make:mcp-tool、make:mcp-prompt、make:mcp-resource、make:mcp-app-resource与mcp:start、mcp:inspector带你从零搭建到调试验证一套命令流走完 MCP 开发全流程。 控制台命令总览laravel/mcp 的命令都定义在src/Console/Commands/目录下按功能分为两类命令作用源码位置php artisan make:mcp-server {name}生成 MCP 服务器类src/Console/Commands/MakeServerCommand.phpphp artisan make:mcp-tool {name}生成 MCP 工具类src/Console/Commands/MakeToolCommand.phpphp artisan make:mcp-prompt {name}生成 MCP 提示词类src/Console/Commands/MakePromptCommand.phpphp artisan make:mcp-resource {name}生成 MCP 资源类src/Console/Commands/MakeResourceCommand.phpphp artisan make:mcp-app-resource {name}生成 App 资源类 关联 Blade 视图src/Console/Commands/MakeAppResourceCommand.phpphp artisan mcp:start {handle}启动指定 handle 的 MCP ServerSTDIOsrc/Console/Commands/StartCommand.phpphp artisan mcp:inspector {handle}打开 MCP Inspector 调试验证src/Console/Commands/InspectorCommand.php 提示make:mcp-server是生成命令并非mcp:server:make。记住make 系命令负责“造”mcp:start负责“跑”mcp:inspector负责“查”。⚡ 一键安装步骤make:mcp-server 快速起步执行php artisan make:mcp-server Weather后命令会基于stubs/mcp-server.stub模板在app/Mcp/Servers/命名空间下生成服务器类并把类名自动转成可读的显示名如Weather→Weather、MyServer→My Server填入#[Name]属性。生成的骨架长这样#[Name(Weather)] #[Version(0.0.1)] #[Instructions(Instructions describing how to use the server and its features.)] class Weather extends Server { protected array $tools []; protected array $resources []; protected array $prompts []; }关键特性可自定义模板如果项目根目录存在stubs/mcp-server.stub会优先使用你自己的模板见src/Console/Commands/MakeServerCommand.php中的getStub()逻辑--force选项类已存在时强制覆盖其余三个 make 命令tool / prompt / resource / app-resource行为一致只是分别生成到Mcp\Tools、Mcp\Prompts、Mcp\Resources命名空间模板分别为stubs/mcp-tool.stub、stubs/mcp-prompt.stub、stubs/mcp-resource.stub。make:mcp-app-resource略有不同它会同时创建 Blade 视图如resources/views/mcp/{name}.blade.php供支持 App 协议的客户端渲染交互式界面。 最快配置方法mcp:start 启动服务器mcp:start的完整用法源码见src/Console/Commands/StartCommand.phpphp artisan mcp:start weather第二个参数handle是服务器的唯一标识必须与你在代码中通过Mcp::local()注册的句柄一致。命令执行逻辑很简单从Registrar注册表按 handle 查找本地服务器找不到时输出明确报错MCP Server with name [xxx] not found. Did you register it using [Mcp::local()]?找到后直接以 STDIO 方式启动AI 客户端即可通过标准输入输出与服务器通信。新手常见坑运行mcp:start报 “not found”99% 是忘记注册。请先确认你在应用引导代码如AppServiceProvider中调用了类似Mcp::local(weather, fn () new Weather);的注册语句。️ Inspector调优调试技巧mcp:inspector 实战mcp:inspector是 laravel/mcp 最强大的调试利器源码见src/Console/Commands/InspectorCommand.php一条命令即可打开官方 MCP Inspector 网页工具在线测试你的工具调用、资源读取与提示词输出。基本用法php artisan mcp:inspector weather调优参数选项说明--host指定 Inspector 绑定的主机地址--port指定 Inspector 客户端端口智能传输检测命令会根据服务器类型自动选择传输方式无需手动配置STDIO 本地服务器自动生成php artisan mcp:start {handle}的子进程配置HTTP 路由服务器自动解析路由生成 URL走 Streamable HTTP 传输若路由带参数如test-mcp/{id}命令会交互式询问每个路由参数的取值只有一个服务器时可省略 handle 参数命令自动帮你选定。启动后终端会打印一份“连接指南”Guidance包含 Transport Type、Command/URL、Config 路径等信息照着填即可在其他 AI 客户端中复现同样配置。排错清单提示 No MCP servers found→ 先运行php artisan make:mcp-server [name]并注册HTTPS 站点 SSL 报错→ 命令会自动设置NODE_TLS_REJECT_UNAUTHORIZED0但文档建议 HTTP 站点更易调试临时配置失败→ 报Unable to write the MCP Inspector configuration file.检查系统临时目录可写性路由参数缺失→ 所有路由参数都必须提供值才能生成 URL。⚙️ 进阶调优config/mcp.php 关键配置配置文件config/mcp.php中有几项与调试和工具调用直接相关的设置tool_search.max_tool_calls默认 10单次工具搜索请求最多可执行的工具调用数tool_search.max_output_bytes默认 65536限制每个搜索结果的最大字节数防止大结果拖垮 AI 客户端redirect_domains/custom_schemesOAuth 授权回调相关调试 Cursor、VS Code 等桌面客户端授权时需配置允许的自定义 scheme如cursor、vscode。 完整工作流小结make:mcp-server → 注册 Mcp::local() → mcp:start 启动 → mcp:inspector 调试 → 接入 AI 客户端造骨架php artisan make:mcp-server MyServer配合make:mcp-tool等补充能力跑起来php artisan mcp:start my-server验效果php artisan mcp:inspector my-server --port 5173调上限修改config/mcp.php中的工具搜索限制掌握这 7 个命令你就拥有了从创建、启动到调试验证 laravel/mcp 项目的完整技能树快速把任何 Laravel 应用变成 AI 可调用的 MCP 服务。【免费下载链接】mcpRapidly build MCP servers for your Laravel applications.项目地址: https://gitcode.com/gh_mirrors/mcp62/mcp创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考