PHPackages                             djinson/laravel-mcp - 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. [API Development](/categories/api)
4. /
5. djinson/laravel-mcp

ActiveLibrary[API Development](/categories/api)

djinson/laravel-mcp
===================

The ultimate Laravel integration for Model-Centric Processing (MCP). Seamlessly connect Azure OpenAI, OpenAI, and Google Gemini to build powerful AI agents with tool use, conversation orchestration, and robust error handling.

v2.1.0(5mo ago)20MITPHPPHP ^8.2CI passing

Since Dec 5Pushed 5mo agoCompare

[ Source](https://github.com/GhassenAbida/djinson_mcp)[ Packagist](https://packagist.org/packages/djinson/laravel-mcp)[ RSS](/packages/djinson-laravel-mcp/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (5)Versions (6)Used By (0)

🚀 Laravel MCP (Model-Centric Processing)
========================================

[](#-laravel-mcp-model-centric-processing)

**Connect your Laravel app to Claude Desktop, OpenAI, and Gemini in minutes. Expose your database and logic as AI tools with zero friction.**

[![Latest Version on Packagist](https://camo.githubusercontent.com/7155009f9e100b3809f59b95ee96c8264cc249e205c1467439ea985b39ea4a3e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646a696e736f6e2f6c61726176656c2d6d63702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/djinson/laravel-mcp)[![Total Downloads](https://camo.githubusercontent.com/320848de8004aae0de9bdc52a82416988ef5b8dfa53d93843b291911ebd568d1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f646a696e736f6e2f6c61726176656c2d6d63702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/djinson/laravel-mcp)[![License](https://camo.githubusercontent.com/38eb7fe2528ee73d42cde6fdbdc3be2c418bbe9997b42675a4339c3291bbd196/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f646a696e736f6e2f6c61726176656c2d6d63702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/djinson/laravel-mcp)[![Tests](https://camo.githubusercontent.com/5e2b6ea15358d2769c8e86930fcc1c5bd629d7c6f6704f8153415ee7c6906512/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f4768617373656e41626964612f646a696e736f6e5f6d63702f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/GhassenAbida/djinson_mcp/actions)

![Laravel MCP Demo]()

Quick Start
-----------

[](#quick-start)

```
composer require djinson/laravel-mcp
```

Requirements
------------

[](#requirements)

- PHP: ^8.2
- Laravel: ^10.0 or ^11.0

Features
--------

[](#features)

- **Multi-Provider Support**: Supports Azure OpenAI, standard OpenAI, and Google Gemini.
- **Centralized Configuration**: Publishes `config/openai-mcp.php` for managing credentials, endpoints, model options, retries, and timeouts.
- **Robust Error Handling**: Custom `LlmException` for specific error handling and structured logging for better observability.
- **Conversation Orchestration**: Manages multi-turn conversations, tool execution, and cycle detection.
- **Prompt Management**: Publishes prompt stubs to `resources/ai-prompts/`.
- **Tool Auto-Discovery**: Automatically discovers and registers `ToolInterface` implementations under `app/MCP/Tools`.
- **Testing Support**: Includes a test suite using `orchestra/testbench` for verification.

Installation
------------

[](#installation)

```
composer require djinson/laravel-mcp
```

### Publish Configuration

[](#publish-configuration)

Publish the configuration file to `config/openai-mcp.php`:

```
php artisan vendor:publish --provider="Djinson\OpenAiMcp\LaravelMcpServiceProvider" --tag="config"
```

### Publish Prompts

[](#publish-prompts)

Publish the default AI prompts to `resources/ai-prompts/`:

```
php artisan vendor:publish --provider="Djinson\OpenAiMcp\LaravelMcpServiceProvider" --tag="openai-mcp-prompts"
```

Configuration
-------------

[](#configuration)

Configure your Azure OpenAI credentials and settings in your `.env` file:

```
AZURE_OPENAI_KEY=your-api-key
AZURE_OPENAI_ENDPOINT=https://your-resource-name.openai.azure.com
AZURE_OPENAI_DEPLOYMENT=gpt-4
AZURE_OPENAI_API_VERSION=2024-02-15-preview
```

You can also customize retries, timeouts, and model parameters in `config/openai-mcp.php`.

Testing
-------

[](#testing)

To run the package tests, you can use `phpunit` or `pest`. If you are on Windows, it is recommended to run tests via WSL.

```
composer install
vendor/bin/phpunit
```

###  Health Score

35

—

LowBetter than 79% of packages

Maintenance72

Regular maintenance activity

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 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 ~1 days

Total

5

Last Release

155d ago

Major Versions

v1.1.0 → v2.02025-12-06

### Community

Maintainers

![](https://www.gravatar.com/avatar/cd5e34376a5e86d38db985a3d8e88a8b740c2f7567b2456f32fa85b9155960fe?d=identicon)[GhassenAbida](/maintainers/GhassenAbida)

---

Top Contributors

[![GhassenAbida](https://avatars.githubusercontent.com/u/92631158?v=4)](https://github.com/GhassenAbida "GhassenAbida (20 commits)")

---

Tags

agentazuregeminilaravelmcpmodelopenailaravelsdkmcpaiopenaiazureAgentGeminillmartificial intelligenceChatGpttool-use

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/djinson-laravel-mcp/health.svg)

```
[![Health](https://phpackages.com/badges/djinson-laravel-mcp/health.svg)](https://phpackages.com/packages/djinson-laravel-mcp)
```

###  Alternatives

[sbsaga/toon

🧠 TOON for Laravel — a compact, human-readable, and token-efficient data format for AI prompts & LLM contexts. Perfect for ChatGPT, Gemini, Claude, Mistral, and OpenAI integrations (JSON ⇄ TOON).

6115.6k](/packages/sbsaga-toon)[claude-php/claude-php-sdk-laravel

Laravel integration for the Claude PHP SDK - Anthropic Claude API

5010.8k](/packages/claude-php-claude-php-sdk-laravel)[vectorifyai/vectorify-laravel

Vectorify package for Laravel. The fastest way to ask AI about your data.

206.1k](/packages/vectorifyai-vectorify-laravel)[gemini-api-php/laravel

Gemini API client for Laravel

8915.7k](/packages/gemini-api-php-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)