|
27 | 27 |
|
28 | 28 | ## Przegląd |
29 | 29 |
|
30 | | -Laravel MCP Server to potężny pakiet zaprojektowany, aby uprościć implementację serwerów Protokołu Kontekstu Modelu (MCP) w aplikacjach Laravel. **W przeciwieństwie do większości pakietów Laravel MCP, które używają transportu Standardowego Wejścia/Wyjścia (stdio)**, ten pakiet **wykorzystuje transport Server-Sent Events (SSE)**, zapewniając bezpieczniejszą i bardziej kontrolowaną metodę integracji. |
| 30 | +Laravel MCP Server to konkretne narzędzie, które ułatwia stworzenie serwerów MCP w Laravelu. **W odróżnieniu od większości innych pakietów, które bazują na stdio**, ten pakiet **korzysta z SSE (Server-Sent Events)**, co daje Ci większe bezpieczeństwo i kontrolę nad integracją. |
31 | 31 |
|
32 | | -### Dlaczego SSE zamiast STDIO? |
| 32 | +### Czemu SSE zamiast STDIO? |
33 | 33 |
|
34 | | -Chociaż stdio jest proste i szeroko stosowane w implementacjach MCP, ma znaczące implikacje bezpieczeństwa dla środowisk korporacyjnych: |
| 34 | +Stdio jest proste i popularne w implementacjach MCP, ale w firmowych środowiskach stwarza spore problemy z bezpieczeństwem: |
35 | 35 |
|
36 | | -- **Ryzyko bezpieczeństwa**: Transport STDIO potencjalnie ujawnia wewnętrzne szczegóły systemu i specyfikacje API |
37 | | -- **Ochrona danych**: Organizacje muszą chronić własnościowe punkty końcowe API i wewnętrzną architekturę systemu |
38 | | -- **Kontrola**: SSE oferuje lepszą kontrolę nad kanałem komunikacji między klientami LLM a Twoją aplikacją |
| 36 | +- **Bezpieczeństwo**: STDIO może wyciec poufne szczegóły systemu i API |
| 37 | +- **Ochrona danych**: Firmy muszą chronić swoje endpointy API i wewnętrzną architekturę |
| 38 | +- **Kontrola**: SSE daje Ci lepszą kontrolę nad komunikacją między klientami LLM a Twoją aplikacją |
39 | 39 |
|
40 | | -Implementując serwer MCP z transportem SSE, przedsiębiorstwa mogą: |
| 40 | +Z serwerem MCP opartym na SSE możesz: |
41 | 41 |
|
42 | | -- Eksponować tylko niezbędne narzędzia i zasoby, zachowując prywatność własnościowych szczegółów API |
43 | | -- Utrzymać kontrolę nad procesami uwierzytelniania i autoryzacji |
| 42 | +- Udostępnić tylko potrzebne narzędzia, chroniąc poufne szczegóły API |
| 43 | +- Lepiej kontrolować procesy uwierzytelniania i autoryzacji |
44 | 44 |
|
45 | | -Kluczowe korzyści: |
| 45 | +Główne zalety: |
46 | 46 |
|
47 | | -- Bezproblemowa i szybka implementacja SSE w istniejących projektach Laravel |
48 | | -- Wsparcie dla najnowszych wersji Laravel i PHP |
49 | | -- Wydajna komunikacja serwera i przetwarzanie danych w czasie rzeczywistym |
50 | | -- Zwiększone bezpieczeństwo dla środowisk korporacyjnych |
| 47 | +- Szybka i łatwa integracja SSE w istniejących projektach Laravel |
| 48 | +- Pełne wsparcie dla najnowszych wersji Laravel i PHP |
| 49 | +- Wydajna komunikacja i przetwarzanie danych na żywo |
| 50 | +- Lepsze bezpieczeństwo dla środowisk firmowych |
51 | 51 |
|
52 | 52 | ## Główne funkcje |
53 | 53 |
|
@@ -104,42 +104,42 @@ class MyCustomTool implements ToolInterface |
104 | 104 |
|
105 | 105 | ### Testowanie narzędzi MCP |
106 | 106 |
|
107 | | -Pakiet zawiera specjalną komendę do testowania twoich narzędzi MCP bez potrzeby posiadania prawdziwego klienta MCP: |
| 107 | +Masz tu fajną komendę do testowania swoich narzędzi MCP bez potrzeby posiadania klienta MCP: |
108 | 108 |
|
109 | 109 | ```bash |
110 | | -# Testuj interaktywnie konkretne narzędzie |
| 110 | +# Testuj narzędzie interaktywnie |
111 | 111 | php artisan mcp:test-tool MyCustomTool |
112 | 112 |
|
113 | | -# Wylistuj wszystkie dostępne narzędzia |
| 113 | +# Zobacz listę wszystkich narzędzi |
114 | 114 | php artisan mcp:test-tool --list |
115 | 115 |
|
116 | | -# Testuj z określonym wejściem JSON |
| 116 | +# Testuj z konkretnym JSON-em |
117 | 117 | php artisan mcp:test-tool MyCustomTool --input='{"param":"wartosc"}' |
118 | 118 | ``` |
119 | 119 |
|
120 | | -Pomaga to szybko rozwijać i debugować narzędzia dzięki: |
| 120 | +Dzięki temu możesz szybko rozwijać i debugować narzędzia: |
121 | 121 |
|
122 | | -- Pokazywaniu schematu wejściowego narzędzia i walidacji danych wejściowych |
123 | | -- Wykonywaniu narzędzia z podanymi przez Ciebie danymi wejściowymi |
124 | | -- Wyświetlaniu sformatowanych wyników lub szczegółowych informacji o błędach |
125 | | -- Obsłudze złożonych typów wejściowych, w tym obiektów i tablic |
| 122 | +- Widzisz schemat wejściowy i walidację danych |
| 123 | +- Testujesz narzędzie z własnymi danymi |
| 124 | +- Dostajesz sformatowane wyniki lub szczegółowe błędy |
| 125 | +- Obsługujesz złożone dane wejściowe, w tym obiekty i tablice |
126 | 126 |
|
127 | | -### Wizualizacja narzędzi MCP za pomocą Inspektora |
| 127 | +### Wizualizacja narzędzi MCP z Inspektorem |
128 | 128 |
|
129 | | -Możesz również użyć Inspektora Protokołu Kontekstu Modelu (Model Context Protocol Inspector) do wizualizacji i testowania swoich narzędzi MCP: |
| 129 | +Możesz też użyć MCP Inspectora do wizualnej pracy z narzędziami: |
130 | 130 |
|
131 | 131 | ```bash |
132 | | -# Uruchom MCP Inspector bez instalacji |
| 132 | +# Odpal Inspektora bez instalacji |
133 | 133 | npx @modelcontextprotocol/inspector node build/index.js |
134 | 134 | ``` |
135 | 135 |
|
136 | | -Zazwyczaj otworzy to interfejs webowy na `localhost:6274`. Aby przetestować swój serwer MCP: |
| 136 | +To otworzy interfejs w przeglądarce na `localhost:6274`. Żeby przetestować swój serwer: |
137 | 137 |
|
138 | | -1. Uruchom serwer deweloperski Laravel (np. `php artisan serve`) |
139 | | -2. W interfejsie Inspektora wprowadź adres URL SSE swojego serwera Laravel (np. `http://localhost:8000/mcp/sse`) |
140 | | -3. Połącz się i przeglądaj dostępne narzędzia wizualnie |
| 138 | +1. Uruchom Laravel (`php artisan serve`) |
| 139 | +2. W Inspektorze wklej URL swojego serwera SSE (np. `http://localhost:8000/mcp/sse`) |
| 140 | +3. Połącz się i testuj narzędzia wizualnie |
141 | 141 |
|
142 | | -Adres URL SSE ma następujący format: `http://[twój-serwer-laravel]/[default_path]/sse`, gdzie `default_path` jest zdefiniowany w pliku `config/mcp-server.php`. |
| 142 | +Format URL SSE to: `http://[twój-serwer]/[default_path]/sse`, gdzie `default_path` ustawiasz w `config/mcp-server.php`. |
143 | 143 |
|
144 | 144 | ## Zaawansowane funkcje |
145 | 145 |
|
|
0 commit comments