PHPackages jose-chan/laravel-mcp-client - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. jose-chan/laravel-mcp-client ActiveLibrary[Utility & Helpers](/categories/utility) jose-chan/laravel-mcp-client ============================ A mcp client for laravel v0.1.2(7mo ago)01MITPHPPHP ^7.1.3 Since Dec 6Pushed 7mo agoCompare [ Source](https://github.com/ILoveJoseM/mcp-client)[ Packagist](https://packagist.org/packages/jose-chan/laravel-mcp-client)[ RSS](/packages/jose-chan-laravel-mcp-client/feed)WikiDiscussions main Synced today READMEChangelogDependencies (7)Versions (4)Used By (0) Laravel MCP Client ================== [](#laravel-mcp-client) 概述 -- [](#概述) Laravel MCP Client是一个用于连接和与MCP (Model Context Protocol)服务器交互的Laravel扩展包。它提供了一个简单而强大的接口，使你的Laravel应用程序能够调用MCP服务器提供的工具、资源和提示词。 MCP是一种标准协议，允许AI模型与外部工具和服务进行交互，大大扩展了AI的能力边界。 功能特性 ---- [](#功能特性) - **工具调用**: 调用MCP服务器提供的各种工具 - **资源管理**: 访问和管理MCP服务器资源 - **提示词管理**: 使用MCP服务器提供的提示词模板 - **命令行交互**: 提供交互式命令行界面 - **缓存支持**: 工具列表缓存，提高性能 - **灵活配置**: 支持HTTP和STDIO两种连接方式 - **完整日志**: 详细的操作日志记录 - **错误处理**: 完善的异常处理和重试机制 版本要求 ---- [](#版本要求) - PHP: 7.1.3+ - Laravel: 5.6+ - jose-chan/llm-connector: ^1.0 - ext-json: \* 安装 -- [](#安装) 1. 使用Composer安装扩展包： ``` composer require jose-chan/laravel-mcp-client ``` 2. 发布配置文件： ``` php artisan vendor:publish --provider=JoseChan\\McpClient\\McpClientServiceProvider --tag=mcp-client ``` 3. 在`.env`文件中添加配置： ``` # MCP客户端协议 (http 或 stdio) MCP_CLIENT_PROTOCOL=http # MCP服务器地址 MCP_SERVER_URL=http://127.0.0.1:30001/mcp # STDIO命令 (当使用stdio协议时) MCP_CLIENT_STDIO_COMMAND=["php", "artisan", "mcp:server"] # 超时设置 MCP_CLIENT_TIMEOUT_TOOLS=30 MCP_CLIENT_TIMEOUT_LIST=10 MCP_CLIENT_TIMEOUT_RESOURCES=20 # 功能开关 MCP_CLIENT_AUTO_FETCH_TOOLS=true MCP_CLIENT_AUTO_FETCH_PROMPTS=false # 缓存配置 MCP_CLIENT_CACHE_ENABLED=true MCP_CLIENT_CACHE_DRIVER=file MCP_CLIENT_CACHE_TTL_TOOLS=60 MCP_CLIENT_CACHE_PREFIX=mcp_client # 重试配置 MCP_CLIENT_RETRY_ATTEMPTS=3 MCP_CLIENT_RETRY_DELAY=1000 # 日志配置 MCP_CLIENT_LOG_TOOL_CALLS=true MCP_CLIENT_LOG_PROMPT_USAGE=true MCP_CLIENT_LOG_RESOURCE_ACCESS=true ``` 使用方法 ---- [](#使用方法) ### 命令行交互 [](#命令行交互) 使用命令行工具与MCP服务器交互： ``` php artisan mcp:client ``` 配置选项 ---- [](#配置选项) ### 基础配置 [](#基础配置) 配置项说明默认值protocol连接协议 (http/stdio)httpserver\_urlMCP服务器地址stdio\_commandSTDIO命令\["php", "artisan", "mcp:server"\]### 超时配置 [](#超时配置) 配置项说明默认值timeout.tools工具调用超时(秒)30timeout.list获取列表超时(秒)10timeout.resources资源读取超时(秒)20### 功能开关 [](#功能开关) 配置项说明默认值features.auto\_fetch\_tools自动获取工具truefeatures.auto\_fetch\_prompts自动获取提示词false### 缓存配置 [](#缓存配置) 配置项说明默认值cache.enabled是否启用缓存truecache.driver缓存驱动filecache.ttl.tools工具缓存时间(分钟)60cache.prefix缓存前缀mcp\_client### 重试配置 [](#重试配置) 配置项说明默认值retry.max\_attempts最大重试次数3retry.delay重试延迟(毫秒)1000### 日志配置 [](#日志配置) 配置项说明默认值logging.log\_tool\_calls记录工具调用truelogging.log\_prompt\_usage记录提示词使用truelogging.log\_resource\_access记录资源访问true故障排除 ---- [](#故障排除) ### 常见问题 [](#常见问题) 1. **连接超时** - 检查MCP服务器是否运行 - 确认服务器地址配置正确 - 调整超时设置 2. **工具调用失败** - 检查工具名称和参数是否正确 - 确认MCP服务器支持该工具 - 查看错误日志获取详细信息 3. **缓存问题** - 清除缓存: `Mcp::clearToolsCache()` - 检查缓存配置是否正确 - 确认缓存驱动已安装 ### 调试技巧 [](#调试技巧) 1. 启用详细日志记录 2. 使用Laravel日志查看详细信息 3. 检查MCP服务器状态 4. 验证配置文件 更新日志 ---- [](#更新日志) ### v1.0.0 [](#v100) - 初始版本 - 基础MCP客户端功能 - 工具调用支持 - 缓存机制 - 命令行交互 许可证 --- [](#许可证) MIT License 作者 -- [](#作者) JoseChan 贡献 -- [](#贡献) 欢迎提交Issue和Pull Request！ 相关链接 ---- [](#相关链接) - [MCP协议规范](https://modelcontextprotocol.io/) - [jose-chan/llm-connector](https://github.com/jose-chan/laravel-llm-connector) --- 如有问题或建议，请联系作者或提交Issue。 ### Health Score 24 — LowBetter than 31% of packages Maintenance65 Regular maintenance activity Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity22 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 3 Last Release 210d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/11416856?v=4)[JoseChan](/maintainers/524233828)[@524233828](https://github.com/524233828) --- Top Contributors [![524233828](https://avatars.githubusercontent.com/u/11416856?v=4)](https://github.com/524233828 "524233828 (4 commits)") --- Tags laravelmcpextension ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/jose-chan-laravel-mcp-client/health.svg) ``` [![Health](https://phpackages.com/badges/jose-chan-laravel-mcp-client/health.svg)](https://phpackages.com/packages/jose-chan-laravel-mcp-client) ``` ### Alternatives [grumpydictator/firefly-iii Firefly III: a personal finances manager. 23.9k69.5k](/packages/grumpydictator-firefly-iii)[firefly-iii/data-importer Firefly III Data Import Tool. 8045.8k](/packages/firefly-iii-data-importer)[markwalet/nova-modal-response A Laravel Nova asset for Modal responses on an action. 17878.9k](/packages/markwalet-nova-modal-response)[joshcirre/instruckt-laravel Visual feedback for AI coding agents — Laravel MCP package 17323.5k2](/packages/joshcirre-instruckt-laravel)[ronasit/laravel-helpers Provided helpers function and some helper class. 2085.6k31](/packages/ronasit-laravel-helpers)[team-nifty-gmbh/tall-datatables Server-side rendered datatables for Laravel and Livewire 1320.9k4](/packages/team-nifty-gmbh-tall-datatables) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)