MCP Server for Agent8

Agent8용 MCP 서버

Agent8 SDK 개발을 지원하기 위해 모델 컨텍스트 프로토콜(MCP)을 구현하는 서버입니다. TypeScript와 pnpm으로 개발되었으며 stdio, SSE, streamable-http 전송을 지원합니다.

특징

이 Agent8 MCP 서버는 다음 MCP 사양 기능을 구현합니다.

프롬프트

• Agent8 SDK용 시스템 프롬프트 : system-prompt-for-agent8-sdk 프롬프트 템플릿을 통해 Agent8 SDK 개발을 위한 최적화된 가이드라인을 제공합니다.

도구

• 코드 예제 검색 : search_code_examples 도구를 사용하여 벡터 데이터베이스에서 관련 Agent8 게임 개발 코드 예제를 검색합니다.
• 게임 리소스 검색 : search_game_resources 도구를 통해 의미적 유사성 매칭을 사용하여 게임 개발 자산(스프라이트, 애니메이션, 사운드 등)을 검색합니다.
• 자산 생성 : 게임 자산 생성을 위한 포괄적인 툴셋:
  • 이미지 : image_asset_generate 도구를 사용하여 2D 게임 자산 생성
  • 시네마틱 : cinematic_asset_generate 도구를 사용하여 시네마틱 시퀀스를 만듭니다.
  • 오디오 : music_generate 및 sfx_generate 도구를 사용하여 음악 트랙과 사운드 효과를 생성합니다.
  • 스카이박스 : skybox_generate 도구를 사용하여 360도 환경 배경 만들기
  • 지원 도구 : 비동기 생성을 위한 상태 확인, 결과 검색 및 대기 유틸리티

설치

지엑스피1

Docker 사용

Docker를 사용하여 이 애플리케이션을 여러 가지 방법으로 실행할 수 있습니다.

옵션 1: GitHub 컨테이너 레지스트리에서 가져오기(권장)

옵션 2: 로컬로 빌드

Docker 환경 구성

Docker를 실행할 때 환경 변수를 구성하는 방법에는 세 가지가 있습니다.

1. --env-file 사용(권장):
   # Create and configure your .env file first cp .env.example .env nano .env # Run with .env file docker run -p 3000:3000 --env-file .env agent8-mcp-server
2. 개별 -e 플래그 사용:
   docker run -p 3000:3000 \ -e SUPABASE_URL=your_supabase_url \ -e SUPABASE_SERVICE_ROLE_KEY=your_service_role_key \ -e OPENAI_API_KEY=your_openai_api_key \ -e MCP_TRANSPORT=sse \ -e PORT=3000 \ -e LOG_LEVEL=info \ agent8-mcp-server
3. Docker Compose 사용(개발/프로덕션 설정용):이 프로젝트에는 다음이 포함된 미리 구성된 docker-compose.yml 파일이 포함되어 있습니다.
   • .env 구성에서 자동 포트 매핑
   • 환경 변수 로딩
   • 데이터 지속성을 위한 볼륨 마운팅
   • 컨테이너 자동 재시작 정책
   • 상태 점검 구성

   서버를 실행하려면:

   docker compose up

   분리 모드로 실행하려면:

   docker compose up -d

필수 환경 변수:

• SUPABASE_URL : 데이터베이스 연결을 위한 Supabase URL
• SUPABASE_SERVICE_ROLE_KEY : 인증을 위한 Supabase 서비스 역할 키
• OPENAI_API_KEY : AI 기능을 위한 OpenAI API 키

Dockerfile은 다단계 빌드 프로세스를 사용하여 최소한의 프로덕션 이미지를 만듭니다.

• 더 작은 크기를 위해 기본 이미지로 Node.js 20 Alpine을 사용합니다.
• 빌드 및 런타임 종속성을 분리합니다.
• 최종 이미지에 필요한 파일만 포함합니다.
• 기본적으로 포트 3000을 노출합니다

용법

명령줄 옵션

지원되는 옵션:

• --debug : 디버그 모드를 활성화합니다
• --transport <type> : 전송 유형(stdio, sse 또는 streamable-http), 기본값: stdio
• --port <number> : SSE 또는 HTTP 전송에 사용할 포트, 기본값: 3000
• --log-destination <dest> : 로그 대상(stdout, stderr, file, none)
• --log-file <path> : 로그 파일 경로(log-destination이 file인 경우)
• --log-level <level> : 로그 레벨(디버그, 정보, 경고, 오류), 기본값: 정보
• --env-file <path> : .env 파일 경로

환경 변수 사용

서버는 환경 변수를 통한 구성을 지원하며, 환경 변수는 직접 설정하거나 .env 파일을 통해 설정할 수 있습니다.

1. 프로젝트 루트에 .env 파일을 만듭니다(참조는 .env.example 참조하세요).

2. 서버를 실행합니다( .env 파일이 자동으로 로드됩니다):

3. 또는 .env 파일에 대한 사용자 지정 경로를 지정합니다.

구성 우선 순위

서버는 구성 값을 결정할 때 다음과 같은 우선 순위를 사용합니다.

1. 명령줄 인수(가장 높은 우선순위)
2. 환경 변수( .env 파일 또는 시스템 환경)
3. 기본값(가장 낮은 우선순위)

이를 통해 필요할 때 명령줄 인수를 통해 특정 설정을 재정의하면서 .env 파일에서 기준 구성을 설정할 수 있습니다.

지원되는 환경 변수

도구 활성화 우선 순위 : 도구 활성화 설정은 다음 우선 순위를 따릅니다.

1. 개별 도구 설정(예: ENABLE_CODE_EXAMPLE_SEARCH_TOOL )
2. 자산 유형 설정(예: ENABLE_IMAGE_GENERATION_TOOLS , ENABLE_CINEMATIC_GENERATION_TOOLS )
3. 도구 그룹 설정(예: ENABLE_VECTOR_SEARCH_TOOLS , ENABLE_ASSET_GENERATE_TOOLS )
4. 글로벌 도구 설정( ENABLE_ALL_TOOLS )

개별 설정은 항상 그룹 설정보다 우선하며, 그룹 설정은 전역 설정보다 우선합니다. 개별 설정을 명시적으로 설정하면 상위 설정보다 우선합니다.

중요 : 특정 도구만 활성화하려면 모든 상위 설정을 false 로 설정하고 필요한 특정 도구만 활성화해야 합니다. 이렇게 하면 더욱 일관되고 예측 가능한 구성을 얻을 수 있습니다.

예시 :

Stdio Transport 사용

SSE 전송 사용

스트리밍 가능한 HTTP 전송 사용

디버그 모드

사용 가능한 프롬프트

• systemprompt-agent8-sdk

클라이언트 통합

Claude Desktop과 함께 사용

1. Claude Desktop 구성 파일( claude_desktop_config.json )에 다음을 추가합니다.

1. Claude Desktop을 다시 시작하세요

새로운 프롬프트 추가

src/prompts/provider.ts 파일의 registerSamplePrompts 메서드에 새로운 프롬프트를 추가합니다.

특허

MIT