Question 1

Dlaczego niektórzy klienci zgłaszają błąd KeyError: 'position' podczas inicjalizacji narzędzia?

Accepted Answer

Niektórzy klienci MCP mogą napotkać problemy przy parsowaniu schematów narzędzi, gdy zawierają one lokalne odwołania JSON pointer, takie jak #/properties/position. MCP Unity unika tego, rejestrując wejścia narzędzi transformacji (set_transform, move_gameobject, rotate_gameobject, scale_gameobject) z nowymi, zagnieżdżonymi schematami wektorów dla każdego pola, dzięki czemu wygenerowany schemat nie zależy od lokalnych odwołań #/properties/... . Jeśli nadal widzisz ten błąd: zaktualizuj swojego klienta MCP do najnowszej wersji, przebuduj serwer Node (cd Server~ && npm run build), upewnij się, że wersja pakietu zawiera poprawkę kompatybilności.

Question 2

Dlaczego pojawia się błąd „connection failed” podczas uruchamiania testów w trybie Play?

Accepted Answer

Narzędzie run_tests zwraca następującą odpowiedź: Error: Connection failed: Unknown error. Ten błąd występuje, ponieważ połączenie mostka zostaje utracone podczas przeładowywania domeny przy przełączaniu do trybu Play. Rozwiązaniem jest wyłączenie opcji Reload Domain w Edit > Project Settings > Editor > "Enter Play Mode Settings".

Question 3

Dlaczego serwer MCP Unity nie uruchamia się?

Accepted Answer

Sprawdź konsolę Unity pod kątem komunikatów o błędach. Upewnij się, że Node.js jest poprawnie zainstalowany i dostępny w zmiennej PATH. Zweryfikuj, czy wszystkie zależności są zainstalowane w katalogu Server.

Question 4

Dlaczego nie mogę połączyć się z MCP Unity?

Accepted Answer

Upewnij się, że serwer WebSocket działa (sprawdź okno Server w Unity). Wyślij komunikat logu konsoli z klienta MCP, aby wymusić ponowne połączenie między klientem MCP a serwerem Unity. Zmień numer portu w oknie MCP Server w Unity Editor (Narzędzia > MCP Unity > Server Window).

Question 5

Is MCP Unity free to use?

Accepted Answer

Yes, MCP Unity is an open-source project distributed under the MIT License. You are free to use, modify, and distribute it according to the license terms.

Question 6

Czy mogę rozszerzyć MCP Unity o własne narzędzia dla mojego projektu?

Accepted Answer

Tak, zdecydowanie! Jedną z najważniejszych zalet architektury MCP Unity jest jej rozszerzalność. W Unity (C#): możesz tworzyć nowe klasy C#, które dziedziczą po McpToolBase (lub podobnej bazie dla zasobów), aby udostępnić własną funkcjonalność w Unity Editorze. Narzędzia te zostaną następnie zarejestrowane w pliku McpUnityServer.cs. Na przykład możesz napisać narzędzie automatyzujące specyficzny pipeline importu zasobów, charakterystyczny dla twojego projektu. W serwerze Node.js (TypeScript): definiujesz odpowiedni handler TypeScript w katalogu Server/src/tools/, wraz ze schematem Zod dla wejść/wyjść, i rejestrujesz go w Server/src/index.ts. Ta część Node.js przekieruje żądanie do nowego narzędzia C# w Unity. Dzięki temu możesz dostosować możliwości AI do konkretnych potrzeb i przepływów pracy w grze lub aplikacji.

Question 7

Jakie hosty MCP i IDE obecnie wspierają MCP Unity?

Accepted Answer

MCP Unity jest zaprojektowany tak, aby działał z każdym asystentem AI lub środowiskiem programistycznym, które może pełnić rolę klienta MCP. Ekosystem rośnie, ale obecnie znane integracje lub kompatybilne platformy obejmują: Cursor, Windsurf, Claude Desktop, Claude Code, Codex, CLI, GitHub Copilot, Google Antigravity, OpenCode.

Question 8

Czym jest MCP Unity?

Accepted Answer

MCP Unity to potężny most łączący środowisko Unity Editor z asystentami AI i narzędziami LLM przy użyciu Model Context Protocol (MCP). W praktyce MCP Unity: udostępnia funkcje Unity Editor (takie jak tworzenie obiektów, modyfikowanie komponentów, uruchamianie testów itp.) jako „narzędzia” i „zasoby”, które AI może rozumieć i wykorzystywać. Uruchamia serwer WebSocket wewnątrz Unity oraz serwer Node.js (działający jako klient WebSocket dla Unity), który implementuje MCP. To pozwala asystentom AI wysyłać komendy do Unity i odbierać zwrotnie informacje. Dzięki temu możesz używać naturalnych poleceń językowych z asystentem AI, aby wykonywać złożone zadania w projekcie Unity, znacząco przyspieszając przepływ pracy.

Question 9

Jak MCP Unity wypada w porównaniu z nadchodzącymi funkcjami AI w Unity 6.2?

Accepted Answer

Unity 6.2 ma wprowadzić nowe wbudowane narzędzia AI, w tym poprzednie Unity Muse (do generatywnych zastosowań AI, takich jak generowanie tekstur i animacji) oraz Unity Sentis (do uruchamiania sieci neuronowych w środowisku uruchomieniowym Unity). Ponieważ Unity 6.2 nie jest jeszcze w pełni wydany, porównanie opiera się na dostępnych publicznie informacjach i przewidywanych funkcjonalnościach:

**Focus / Główny cel:**
- **MCP Unity:** Skupia się głównie na automatyzacji i interakcji w Edytorze. Pozwala zewnętrznym systemom AI (np. asystentom kodującym opartym na LLM) kontrolować i zapytywać sam Edytor Unity, aby manipulować scenami, zasobami i ustawieniami projektu. Chodzi o augmentację przepływu pracy dewelopera w Edytorze.
- **AI w Unity 6.2:** Celuje w tworzenie treści w Edytorze (generowanie tekstur, sprite'ów, animacji, zachowań, skryptów) oraz asystę AI w typowych zadaniach, bezpośrednio zintegrowaną z interfejsem Edytora Unity. Dostarcza model dostrojony do odpowiadania na pytania o dokumentację Unity i strukturę API, z przykładami dopasowanymi do środowiska Unity. Dodaje także możliwość uruchamiania wnioskowania modelu AI, co pozwala deweloperom wdrażać i uruchamiać wstępnie wytrenowane sieci neuronowe w grze lub aplikacji (np. zachowanie NPC, rozpoznawanie obrazów itp.).

**Przypadki użycia:**
- **MCP Unity:**
  - „Utwórz nowy obiekt 3D, nazwij go 'Player', dodaj Rigidbody i ustaw masę na 10.”
  - „Uruchom wszystkie testy trybu Play.”
  - „Poproś o naprawę błędu w kons

Question 10

Dlaczego warto używać MCP Unity?

Accepted Answer

MCP Unity oferuje kilka przekonujących zalet dla programistów, artystów i menedżerów projektów:

- Przyspieszone tworzenie: Automatyzuje powtarzalne zadania, generuje kod szkieletowy i zarządza zasobami przy użyciu zapytań AI. Dzięki temu zyskujesz czas na kreatywne i złożone rozwiązywanie problemów.
- Zwiększona produktywność: Pozwala wchodzić w interakcję z funkcjami Unity Editor bez konieczności ręcznego klikania w menu czy pisania skryptów do prostych operacji. Asystent AI staje się bezpośrednim rozszerzeniem Twoich możliwości w Unity.
- Lepsza dostępność: Umożliwia użytkownikom, którzy nie są zaznajomieni z głębokimi niuansami Unity Editor czy programowaniem w C#, wnoszenie istotnych wkładów i modyfikacji do projektu dzięki wsparciu AI.
- Bezproblemowa integracja: Zaprojektowany do współpracy z różnymi asystentami AI i IDE obsługującymi MCP, zapewniając spójny sposób wykorzystywania AI w całym zestawie narzędzi deweloperskich.
- Rozszerzalność: Protokół i zestaw narzędzi mogą być rozwijane. Możesz definiować nowe narzędzia i zasoby, aby udostępnić AI większą część funkcjonalności specyficznej dla Twojego projektu lub Unity.
- Potencjał współpracy: Umożliwia nowy sposób współdziałania, w którym AI pomaga w zadaniach tradycyjnie wykonywanych przez członków zespołu lub wspiera wdrażanie nowych programistów, prowadząc ich przez strukturę i operacje projektu.

mcp-unityTen serwer MCP łączy asystentów kodowania AI bezpośrednio z edytorem gier Unity. Możesz budować sceny, przenosić obiekty, zmieniać materiały i uruchamiać testy po prostu wpisując instrukcje, co oszczędza czas i

Przegląd

Kluczowe funkcje

Cennik

Zastosowania

Rozwój gier

Kodowanie wspomagane przez AI

Plusy i minusy

Plusy

Minusy

Recenzje

Pytania i odpowiedzi

Zadaj pytanie

Alternatywy dla Serwery MCP

Playwright MCP

Pydantic AI

Cognee

Inbox Zero

Screenpipe

AgentKit

onchain-mcp

markitdown