firekula/mcp-bridge

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

236 stars 80 forks 품질 74 트렌드 22NOASSERTION

Cocos Creator 2.4.x MCP 브리지 — 로컬 HTTP 서비스를 실행하여 Claude 및 기타 AI가 모델 컨텍스트 프로토콜을 통해 편집기를 직접 제어할 수 있게 합니다: 30+ 도구가 완전 자동화되어 있으며, 씬 노드 관리, 컴포넌트 추가, 삭제, 수정, 쿼리, 오프라인 프리폼 수정, 리소스 관리, 프로젝트 구성 등 다양한 기능을 포함합니다. — QQ 그룹: 788307395

개요

이 플러그인은 Cocos Creator용으로 설계된 MCP(Model Context Protocol) 브리지 플러그인으로, 외부 AI 도구를 Cocos Creator 편집기와 연결하여 씬, 노드 및 기타 자원에 대한 자동화 작업을 가능하게 합니다. 이 플러그인은 Cocos Creator 버전 2.4.x와 호환됩니다. 특정 편집기 API를 사용하기 때문에 최신 또는 구버전 버전과는 호환되지 않을 수 있습니다. - : 표준 HTTP 인터페이스를 제공하며, 외부 도구가 MCP 프로토콜을 통해 Cocos Creator 편집기 기능을 호출 수 있음 - : 씬 내 노드 검색, 생성 및 수정 - : 씬 및 프리셋 생성, 편집 모드 전환을 위한 씬 또는 프리셋 열기 - : 노드 컴포넌트 추가, 삭제, 가져오기 - : 스크립트 파일 생성, 삭제, 읽기, 쓰기 - : 효율성 향상을 위해 여러 MCP 도구 작업을 배치 실행 - : 자원 정보를 생성, 삭제, 이동 및 가져오기 - : 빠르고 안전한 오프라인 편집기 엔진. 프리패브릭(.prefab)과 씬(.fire) 간 물리적 골격 차이를 자동으로 인식합니다. 리소스 골격 생성, 딥 카피 참조 재계산 클로닝, 렌더 레벨 재정렬, 중첩 배열 참조 바인딩(clickEvents[0].target), 속성 참조 바인딩, 그리고 물리적 삭제 + 심층 재귀 참조 업데이트를 지원하여 충돌 방지. 편집기의 개인 직렬화 필드(_N$)는 자동으로 동기화되어 디직렬화 교착 상태와 워처 차단을 완전히 제거합니다. - : 상세한 작업 로그 기록 및 표시 제공, 프로젝트 로그 파일에 대한 영구 기록 지원 - : : 에디터가 시작될 때 자동 서비스 시작 지원 - : 선택한 객체 생성 및 설정, 에디터 새로고침 - : 조건에 따라 씬 내 노드 찾기 - : 재질 자원 생성 및 관리 - : 텍스처 리소스 생성 및 관리 - : Cocos 크리에이터 편집기 메뉴 항목 실행 - : 파일에 텍스트 편집 작업 적용 - : 편집기 콘솔 출력 읽기 - : 스크립트 문법 정확성 검증 - : 프로젝트 내 텍스트 콘텐츠 검색 - : 편집기의 실행 취소 스택 관리 - : 파티클 시스템 생성 및 수정 - : 명령 큐는 직렬로 실행되며, 큐 항목 한도는 100개(초과 제한 시 HTTP 429를 반환함) 에디터 정지 방지 - : IPC 통신과 명령 큐는 타임아웃 안전 메커니즘을 갖추고 있습니다 - : 핵심 컴포넌트 속성 블랙리스트 메커니즘은 노드/UUID 참조를 조작해 AI가 충돌하는 것을 방지 - : 매개변수 별칭 매핑(operation→action, 저장→update/write), 대형 모델 착시 호환 - : 지정된 노드나 자원이 참조되는 장면 내 모든 위치를 찾고, Texture2D → 지원...

개요(AI 번역)

이 플러그인은 Cocos Creator용으로 설계된 MCP(Model Context Protocol) 브리지 플러그인으로, 외부 AI 도구를 Cocos Creator 편집기와 연결하여 씬, 노드 및 기타 자원에 대한 자동화 작업을 가능하게 합니다.

적용 가능한 버전

이 플러그인은 Cocos Creator 버전 2.4.x와 호환됩니다. 특정 편집기 API를 사용하기 때문에 최신 또는 구버전 버전과는 호환되지 않을 수 있습니다.

기능적 특징

HTTP 서비스 인터페이스: 표준 HTTP 인터페이스를 제공하여 외부 도구가 MCP 프로토콜을 통해 Cocos Creator 편집기 기능을 호출할 수 있게 합니다
씬 노드 연산: 씬 내 노드를 검색, 생성 및 수정
리소스 관리: 씬과 프리폼을 생성한 후 씬이나 프리폼을 열고 편집 모드에 들어갑니다
컴포넌트 관리: 노드 컴포넌트 추가, 삭제 및 조회
스크립트 관리: 스크립트 파일 생성, 삭제, 읽기 및 쓰기
배치 실행: 효율성을 높이기 위한 다중 MCP 도구 연산의 배치 실행
자산 관리: 자원 정보 생성, 삭제, 이동 및 검색
오프라인 프리셋/씬 수정: 고속, 안전한 오프라인 에디터 엔진. 프리셋(.prefab)과 씬(.fire) 간의 물리적 골격 차이를 자동으로 감지합니다. 자원 스켈레톤 처음부터 생성, 딥 카피 참조 재계산 클로닝, 렌더 레벨 재정렬, 중첩 배열 참조 바인딩(clickEvents[0].target), 속성 참조 바인딩, 물리적 삭제 + 딥 재귀 참조 업데이트를 통해 크래시 방지를 지원합니다. 편집기의 프라이빗 직렬화 필드(_N$)가 자동으로 동기화되어 디직렬라이저 교착 및 워처 차단을 완전히 제거합니다
실시간 로그: 상세한 작업 로그 기록과 표시를 제공하며, 프로젝트 로그 파일에 대한 지속적인 기록 작성 지원을 제공합니다
자동 시작: 편집기가 시작될 때 자동으로 서비스를 활성화하는 기능을 지원합니다
에디터 관리: 선택한 객체를 검색하고 설정하며, 에디터를 새로고침합니다.
게임 오브젝트 검색: 조건에 따라 씬 내 노드를 찾습니다
자재 관리: 자재 자원을 생성하고 관리
텍스처 관리: 텍스처 리소스 생성 및 관리
메뉴 항목 실행: Cocos Creator 편집기 메뉴 항목 실행
코드 편집 향상: 파일에 텍스트 편집 작업 적용
콘솔 읽기: 편집기 콘솔에서 출력을 읽습니다
스크립트 검증: 스크립트의 문법 정확성을 검증합니다
글로벌 검색: 프로젝트 내 텍스트 콘텐츠 검색
되돌리기/다시 실행: 편집기의 실행 취소 스택 관리
특수 효과 관리: 파티클 시스템 생성 및 수정
동시성 보안: 명령 큐는 직렬 모드로 실행되며, 큐 한도는 100개 항목(초과 반환 시 HTTP 429)으로 설정되어 편집기 정지 방지
타임아웃 보호: IPC 통신 및 명령 큐에는 타임아웃 안전 메커니즘이 있습니다
속성 보호: node/[uuid 같은 참조를 AI가 조작하지 못하도록 컴포넌트에 대한 핵심 속성 블랙리스트 메커니즘

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

설치

npx tsc --noEmit

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
    "mcpServers": {
        "mcp-bridge": {
            "command": "node",
            "args": ["[插件安装路径]/dist/mcp-proxy.js"]
        }
    }
}