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(5mo ago)01MITPHPPHP ^7.1.3 Since Dec 6Pushed 5mo 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 1mo ago 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 26 — LowBetter than 43% of packages Maintenance72 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 157d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f12bdb88f1ac67fe7ca894318d891f7684edd60ad5c55f1015a49086bd7c1139?d=identicon)[524233828](/maintainers/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 [livewire/volt An elegantly crafted functional API for Laravel Livewire. 4195.3M84](/packages/livewire-volt)[forxer/laravel-gravatar A library providing easy gravatar integration in a Laravel project. 4235.6k](/packages/forxer-laravel-gravatar)[iteks/laravel-enum A comprehensive Laravel package providing enhanced enum functionalities, including attribute handling, select array conversions, and fluent facade interactions for robust enum management in Laravel applications. 2516.7k](/packages/iteks-laravel-enum)[mateffy/laravel-codebase-mcp An MCP server to give Cursor, Aider, etc. the ability to introspect your Laravel codebase directly, by querying for your models, views, routes and classes without raw file search. 201.1k](/packages/mateffy-laravel-codebase-mcp) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)