Skip to content

Commit b412838

Browse files
committed
Polishing languages
1 parent 1194276 commit b412838

File tree

6 files changed

+126
-126
lines changed

6 files changed

+126
-126
lines changed

README.ko.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<h1 align="center">OP.GG의 Laravel MCP 서버</h1>
22

33
<p align="center">
4-
Model Context Protocol 서버를 쉽게 구축할 수 있는 강력한 라라벨 패키지
4+
Model Context Protocol 서버를 쉬운 구축을 위한 강력한 라라벨 패키지
55
</p>
66

77
<p align="center">
@@ -27,15 +27,15 @@
2727

2828
## 개요
2929

30-
Laravel MCP Server는 라라벨 애플리케이션에서 Model Context Protocol(MCP) 서버를 쉽게 구현할 수 있도록 설계된 강력한 패키지입니다. **대부분의 라라벨 MCP 패키지가 표준 입출력(stdio) 전송 방식을 사용하는 것과 달리**, 이 패키지는 **서버 센트 이벤트(SSE) 전송 방식을 활용**하여 더 안전하고 통제된 통합 방법을 제공합니다.
30+
Laravel MCP Server는 라라벨 앱에서 Model Context Protocol(MCP) 서버를 쉬운 구현을 위해 설계된 강력한 패키지입니다. **대부분의 라라벨 MCP 패키지가 표준 입출력(stdio)사용하는 것과 달리**, 이 패키지는 **서버 센트 이벤트(SSE)활용** 더 안전하고 잡기 좋은 통합 방법을 제공합니다.
3131

3232
### 왜 STDIO 대신 SSE인가?
3333

34-
stdio는 간단하고 MCP 구현에 널리 사용되지만, 기업 환경에서는 중요한 보안 문제를 야기할 수 있습니다:
34+
stdio는 간단하고 MCP 구현에 널리 쓰이지만, 기업 환경에서는 중요한 보안 문제를 일으킬 수 있습니다:
3535

3636
- **보안 위험**: STDIO 전송은 시스템 내부 정보와 API 명세를 노출시킬 가능성이 있음
3737
- **데이터 보호**: 기업은 독점 API 엔드포인트와 내부 시스템 아키텍처를 보호해야 함
38-
- **제어성**: SSE는 LLM 클라이언트와 애플리케이션 간의 통신 채널에 대한 더 나은 제어를 제공함
38+
- **제어성**: SSE는 LLM 클라이언트와 앱 간 통신 채널을 더 잘 제어할 수 있음
3939

4040
SSE 전송을 통해 MCP 서버를 구현하면 기업은 다음과 같은 이점을 얻을 수 있습니다:
4141

@@ -44,10 +44,10 @@ SSE 전송을 통해 MCP 서버를 구현하면 기업은 다음과 같은 이
4444

4545
주요 이점:
4646

47-
- 기존 라라벨 프로젝트에 SSE를 빠르고 쉽게 구현 가능
48-
- 최신 라라벨 및 PHP 버전 지원
49-
- 효율적인 서버 통신 및 실시간 데이터 처리
50-
- 기업 환경을 위한 향상된 보안
47+
- 기존 라라벨 프로젝트에 SSE를 빠르고 쉬운 구현 가능
48+
- 최신 라라벨과 PHP 버전 지원
49+
- 효율적인 서버 통신과 실시간 데이터 처리
50+
- 기업 환경을 위한 강화된 보안
5151

5252
## 주요 기능
5353

@@ -129,17 +129,17 @@ php artisan mcp:test-tool MyCustomTool --input='{"param":"값"}'
129129
Model Context Protocol 인스펙터를 사용하여 MCP 도구를 시각화하고 테스트할 수도 있습니다:
130130

131131
```bash
132-
# 설치 없이 MCP 인스펙터 실행
132+
# 별도 설치 없이 MCP 인스펙터 바로 실행
133133
npx @modelcontextprotocol/inspector node build/index.js
134134
```
135135

136-
이 명령어는 일반적으로 `localhost:6274`에서 웹 인터페이스를 엽니다. MCP 서버를 테스트하려면:
136+
이 명령어는 보통 `localhost:6274` 웹 인터페이스를 띄워줍니다. MCP 서버 테스트 방법:
137137

138138
1. Laravel 개발 서버를 시작합니다(예: `php artisan serve`)
139139
2. 인스펙터 인터페이스에서 Laravel 서버의 MCP SSE URL을 입력합니다(예: `http://localhost:8000/mcp/sse`)
140140
3. 연결하고 사용 가능한 도구를 시각적으로 탐색합니다
141141

142-
SSE URL은 `http://[your-laravel-server]/[default_path]/sse` 패턴을 따르며, 여기서 `default_path``config/mcp-server.php` 파일에 정의되어 있습니다.
142+
SSE URL은 `http://[라라벨서버주소]/[default_path]/sse` 형태로, 여기서 `default_path``config/mcp-server.php` 정의되어 있습니다.
143143

144144
## 고급 기능
145145

@@ -169,7 +169,7 @@ SSE URL은 `http://[your-laravel-server]/[default_path]/sse` 패턴을 따르며
169169
'adapters' => [
170170
'redis' => [
171171
'prefix' => 'mcp_sse_', // Redis 키 접두사
172-
'connection' => 'default', // database.php의 Redis 연결
172+
'connection' => 'default', // database.php에 정의된 Redis 연결
173173
'ttl' => 100, // 메시지 TTL(초)
174174
],
175175
],

README.pl.md

Lines changed: 31 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -27,27 +27,27 @@
2727

2828
## Przegląd
2929

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ą.
3131

32-
### Dlaczego SSE zamiast STDIO?
32+
### Czemu SSE zamiast STDIO?
3333

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:
3535

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ą
3939

40-
Implementując serwer MCP z transportem SSE, przedsiębiorstwa mogą:
40+
Z serwerem MCP opartym na SSE możesz:
4141

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
4444

45-
Kluczowe korzyści:
45+
Główne zalety:
4646

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
5151

5252
## Główne funkcje
5353

@@ -104,42 +104,42 @@ class MyCustomTool implements ToolInterface
104104

105105
### Testowanie narzędzi MCP
106106

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:
108108

109109
```bash
110-
# Testuj interaktywnie konkretne narzędzie
110+
# Testuj narzędzie interaktywnie
111111
php artisan mcp:test-tool MyCustomTool
112112

113-
# Wylistuj wszystkie dostępne narzędzia
113+
# Zobacz listę wszystkich narzędzi
114114
php artisan mcp:test-tool --list
115115

116-
# Testuj z określonym wejściem JSON
116+
# Testuj z konkretnym JSON-em
117117
php artisan mcp:test-tool MyCustomTool --input='{"param":"wartosc"}'
118118
```
119119

120-
Pomaga to szybko rozwijać i debugować narzędzia dzięki:
120+
Dzięki temu możesz szybko rozwijać i debugować narzędzia:
121121

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
126126

127-
### Wizualizacja narzędzi MCP za pomocą Inspektora
127+
### Wizualizacja narzędzi MCP z Inspektorem
128128

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:
130130

131131
```bash
132-
# Uruchom MCP Inspector bez instalacji
132+
# Odpal Inspektora bez instalacji
133133
npx @modelcontextprotocol/inspector node build/index.js
134134
```
135135

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:
137137

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
141141

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`.
143143

144144
## Zaawansowane funkcje
145145

README.pt-BR.md

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -27,27 +27,27 @@
2727

2828
## Visão Geral
2929

30-
Laravel MCP Server é um pacote robusto desenvolvido para facilitar a implementação de servidores de Protocolo de Contexto de Modelo (MCP) em aplicações Laravel. **Diferente da maioria dos pacotes Laravel MCP que usam transporte de Entrada/Saída Padrão (stdio)**, este pacote **utiliza transporte de Eventos Enviados pelo Servidor (SSE)**, oferecendo um método de integração mais seguro e controlado.
30+
O Laravel MCP Server é um pacote poderoso feito pra facilitar a implementação de servidores MCP (Model Context Protocol) em apps Laravel. **Ao contrário da maioria dos pacotes MCP pro Laravel que usam stdio (entrada/saída padrão)**, este pacote **usa SSE (Server-Sent Events)**, proporcionando uma integração mais segura e com melhor controle.
3131

32-
### Por que SSE ao invés de STDIO?
32+
### Por que SSE em vez de STDIO?
3333

34-
Embora o stdio seja direto e amplamente usado em implementações MCP, ele apresenta implicações significativas de segurança para ambientes empresariais:
34+
Apesar do stdio ser simples e muito usado nas implementações de MCP, ele traz problemas sérios de segurança em ambientes corporativos:
3535

36-
- **Risco de Segurança**: O transporte STDIO potencialmente expõe detalhes internos do sistema e especificações de API
37-
- **Proteção de Dados**: Organizações precisam proteger endpoints de API proprietários e arquitetura interna do sistema
38-
- **Controle**: SSE oferece melhor controle sobre o canal de comunicação entre clientes LLM e sua aplicação
36+
- **Risco de Segurança**: O STDIO pode expor detalhes internos do sistema e especificações de API
37+
- **Proteção de Dados**: Empresas precisam proteger seus endpoints de API e a arquitetura interna
38+
- **Controle**: O SSE dá um controle muito melhor sobre a comunicação entre clientes LLM e sua app
3939

40-
Ao implementar o servidor MCP com transporte SSE, empresas podem:
40+
Usando SSE pro servidor MCP, as empresas conseguem:
4141

42-
- Expor apenas as ferramentas e recursos necessários mantendo privados os detalhes proprietários da API
43-
- Manter controle sobre processos de autenticação e autorização
42+
- Expor as ferramentas e recursos necessários, mantendo os detalhes da API privados
43+
- Controlar melhor os processos de autenticação e autorização
4444

45-
Principais benefícios:
45+
Principais vantagens:
4646

47-
- Implementação rápida e simples de SSE em projetos Laravel existentes
48-
- Suporte para as versões mais recentes de Laravel e PHP
49-
- Comunicação eficiente do servidor e processamento de dados em tempo real
50-
- Segurança aprimorada para ambientes empresariais
47+
- Implementação rápida e fácil de SSE em projetos Laravel existentes
48+
- Suporte às versões mais recentes do Laravel e PHP
49+
- Comunicação eficiente e processamento de dados em tempo real
50+
- Segurança reforçada pra ambientes corporativos
5151

5252
## Recursos Principais
5353

@@ -84,12 +84,12 @@ O pacote fornece comandos Artisan convenientes para gerar novas ferramentas:
8484
php artisan make:mcp-tool MyCustomTool
8585
```
8686

87-
Este comando:
87+
Esse comando:
8888

89-
- Lida com vários formatos de entrada (espaços, hífens, case misto)
90-
- Converte automaticamente o nome para o formato de case adequado
91-
- Cria uma classe de ferramenta estruturada corretamente em `app/MCP/Tools`
92-
- Oferece a opção de registrar automaticamente a ferramenta na sua configuração
89+
- Aceita vários formatos de entrada (com espaços, hífens, caixa mista)
90+
- Converte o nome pro formato de case correto automaticamente
91+
- Cria uma classe bem estruturada em `app/MCP/Tools`
92+
- Oferece pra registrar a ferramenta na sua configuração automaticamente
9393

9494
Você também pode criar e registrar ferramentas manualmente no `config/mcp-server.php`:
9595

@@ -124,22 +124,22 @@ Isso ajuda você a desenvolver e depurar ferramentas rapidamente:
124124
- Exibindo resultados formatados ou informações detalhadas de erro
125125
- Suportando tipos complexos de entrada, incluindo objetos e arrays
126126

127-
### Visualizando Ferramentas MCP com o Inspector
127+
### Visualização de Ferramentas MCP com o Inspector
128128

129-
Você também pode usar o Model Context Protocol Inspector para visualizar e testar suas ferramentas MCP:
129+
Dá pra usar o Inspector do MCP pra visualizar e testar suas ferramentas:
130130

131131
```bash
132-
# Execute o MCP Inspector sem instalação
132+
# Roda o MCP Inspector sem precisar instalar
133133
npx @modelcontextprotocol/inspector node build/index.js
134134
```
135135

136-
Isso normalmente abrirá uma interface web em `localhost:6274`. Para testar seu servidor MCP:
136+
Isso vai abrir uma interface web em `localhost:6274`. Pra testar seu servidor MCP:
137137

138-
1. Inicie seu servidor de desenvolvimento Laravel (ex: `php artisan serve`)
139-
2. Na interface do Inspector, insira a URL SSE do seu servidor Laravel (ex: `http://localhost:8000/mcp/sse`)
140-
3. Conecte-se e explore visualmente as ferramentas disponíveis
138+
1. Inicie seu servidor Laravel (`php artisan serve`)
139+
2. No Inspector, coloque a URL SSE do seu servidor (tipo `http://localhost:8000/mcp/sse`)
140+
3. Conecte e explore as ferramentas visualmente
141141

142-
A URL SSE segue o padrão: `http://[seu-servidor-laravel]/[default_path]/sse` onde `default_path` é definido no seu arquivo `config/mcp-server.php`.
142+
A URL SSE segue o formato: `http://[seu-servidor]/[default_path]/sse` onde o `default_path` tá configurado no seu `config/mcp-server.php`.
143143

144144
## Recursos Avançados
145145

README.ru.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -27,27 +27,27 @@
2727

2828
## Обзор
2929

30-
Laravel MCP Server — это мощный пакет, разработанный для упрощения внедрения серверов протокола контекста модели (MCP) в приложениях Laravel. **В отличие от большинства пакетов Laravel MCP, использующих транспорт стандартного ввода/вывода (stdio)**, этот пакет **использует транспорт событий, отправляемых сервером (SSE)**, обеспечивая более безопасный и контролируемый метод интеграции.
30+
Laravel MCP Server — крутой пакет для лёгкого создания MCP серверов в приложениях на Laravel. **В отличие от других MCP пакетов для Laravel, которые используют stdio**, этот пакет **работает через SSE**, что даёт больше безопасности и контроля.
3131

32-
### Почему SSE вместо STDIO?
32+
### Почему SSE а не STDIO?
3333

34-
Хотя stdio прост и широко используется в реализациях MCP, он имеет серьёзные последствия для безопасности корпоративных сред:
34+
Stdio прост и популярен в MCP реализациях, но для бизнес-среды он несёт серьёзные риски:
3535

36-
- **Риск безопасности**: Транспорт STDIO потенциально раскрывает внутренние системные детали и спецификации API
37-
- **Защита данных**: Организациям необходимо защищать проприетарные конечные точки API и внутреннюю архитектуру системы
38-
- **Контроль**: SSE предлагает лучший контроль над каналом связи между клиентами LLM и вашим приложением
36+
- **Безопасность**: STDIO может слить внутренние детали системы и спецификации API
37+
- **Защита данных**: Компаниям нужно защищать свои API и внутреннюю архитектуру
38+
- **Контроль**: SSE даёт лучший контроль над общением между LLM клиентами и вашим приложением
3939

40-
Реализуя сервер MCP с транспортом SSE, предприятия могут:
40+
Используя SSE для MCP сервера, вы можете:
4141

42-
- Предоставлять только необходимые инструменты и ресурсы, сохраняя приватность проприетарных деталей API
43-
- Сохранять контроль над процессами аутентификации и авторизации
42+
- Открыть только нужные инструменты, оставив детали API в тайне
43+
- Лучше контролировать аутентификацию и авторизацию
4444

45-
Ключевые преимущества:
45+
Что это даёт:
4646

47-
- Быстрая и простая реализация SSE в существующих проектах Laravel
48-
- Поддержка последних версий Laravel и PHP
49-
- Эффективная серверная коммуникация и обработка данных в реальном времени
50-
- Повышенная безопасность для корпоративных сред
47+
- Быстрое внедрение SSE в существующие проекты на Laravel
48+
- Работа с новыми версиями Laravel и PHP
49+
- Эффективный обмен данными в реальном времени
50+
- Усиленная безопасность для бизнес-приложений
5151

5252
## Основные функции
5353

0 commit comments

Comments
 (0)