𝗨𝘀𝗲 𝗟𝗮𝗿𝗮𝘃𝗲𝗹 𝘁𝗼 𝗰𝗿𝗲𝗮𝘁𝗲 𝘆𝗼𝘂𝗿 𝗼𝘄𝗻 𝗠𝗖𝗣 𝘀𝗲𝗿𝘃𝗲𝗿
Claude inaweza kufanya kazi na programu yako ya Laravel. Huhitaji kujenga REST API au kuandika client maalum. Unaweza kutoa zana (tools) kupitia Model Context Protocol (MCP).
Pakiti ya laravel/mcp inafanya hili kuwa rahisi. Unaweza kujenga MCP server ndani ya mchana mmoja.
MCP server inatoa vitu vitatu kwa AI: • Tools: Vitendo ambavyo modeli inaita, kama vile kutafuta oda. • Resources: Data ya kusoma tu (read-only) ambayo modeli inachukua kwa ajili ya muktadha. • Prompts: Vipengele (templates) vinavyoweza kutumika tena.
Jinsi ya kuijenga:
- Setup
Sakinisha pakiti kupitia Composer:
composer require laravel/mcp
Toa (publish) njia zako (routes):
php artisan vendor:publish --tag=ai-routes
- Tengeneza Server
Server huunganisha zana na rasilimali zako. Tengeneza moja kwa kutumia:
php artisan make:mcp-server OrdersServer
Iandikishe (register) kwenye routes/ai.php. Unaweza kuendesha web server kwa ajili ya wateja wa mbali (remote clients) au server ya ndani (local server) kwa ajili ya zana kama Claude Code.
- Tengeneza Tools
Tools ndizo zinazofanya kazi halisi. Tengeneza tool kwa kutumia:
php artisan make:mcp-tool SearchOrdersTool
Tool inahitaji njia (methods) mbili: • Schema: Inafafanua ni hoja (arguments) gani modeli inazituma. • Handle: Inatekeleza mantiki (logic) na kurudisha jibu.
Andika maelezo ya wazi. Modeli hutumia maelezo haya kuamua ni lini itumie tool yako.
Tumia Annotations Tumia attributes kuelezea tabia ya tool: • IsReadOnly: Tool haibadili data. • IsDestructive: Tool inabadilisha au kufuta data. • IsIdempotent: Kuiendesha mara mbili inaleta matokeo yaleyale kama mara moja.
Linda Server Yako Web MCP servers ni njia za umma (public endpoints). Zichukulie kama API nyingine yoyote. Tumia middleware kuzilinda. Laravel Sanctum au Passport zinafanya kazi vizuri kwa ajili ya uthibitishaji (authentication).
Jaribu Kazi Yako Tumia MCP Inspector kujaribu server yako kwa mkono:
php artisan mcp:inspector orders
Pia unaweza kuandika majaribio ya kawaida ya PHPUnit ili kuhakikisha zana zako zinafanya kazi kwa usahihi.
Sasa unayo interface ya kawaida kwa ajili ya AI kuingiliana na programu yako. Huhitaji kuandika kodi yoyote ya itifaki (protocol code). Ongeza tu tools, zielezee kwa uwazi, na uzilinde kwa middleware.
Umeunganisha MCP server na nini? Nijulishe kwenye maoni.
Chanzo: https://dev.to/accreditly/use-laravel-to-create-your-own-mcp-server-251g