Bedrock Wiki MCP

Minecraft Bedrock Edition 애드온 개발 지식을 위한 자체 호스팅, 읽기 전용 Model Context Protocol 서버입니다.

상태

마일스톤 0 — 리포지토리/부트스트랩 진행 중입니다. 검색, 인덱싱 및 문서 수집은 의도적으로 아직 구현되지 않았습니다.

계획된 v1 스택은 다음과 같습니다:

• Node.js 24 LTS

• TypeScript

• 공식 Model Context Protocol TypeScript SDK v2

• /mcp에서 제공되는 Streamable HTTP

• SQLite + FTS5 어휘 검색

• Bedrock 인식 파싱, 청크 분할, 정확한 식별자 매칭 및 버전 인식 순위 결정

• 정상 운영에 유료 API 또는 호스팅형 벡터 데이터베이스가 필요 없음

Related MCP server: repocks

설계 제약 조건

• 공개 MCP 기능은 읽기 전용입니다.

• MCP 서버는 지식만 제공하며, 임의의 파일시스템 접근이나 명령 실행은 제공하지 않습니다.

• 안정적인 Microsoft/Mojang 문서가 프리뷰, 과거 또는 커뮤니티 자료보다 우선합니다.

• 프리뷰 및 과거 API 자료는 메타데이터에서 구분 가능하며, 현재 안정적인 답변이 존재하는 경우 기본 검색에서 제외됩니다.

• 생성된 데이터베이스와 소스 체크아웃은 배포 상태이며 Git에 커밋되지 않습니다.

계획된 지식 소스

1. MicrosoftDocs/minecraft-creator — 기본 Creator 문서 및 Script API 참조 자료

2. Mojang/bedrock-samples main — 공식 안정 버전 동작/리소스 팩 샘플

3. Mojang/bedrock-samples preview — 선택적 프리뷰 자료, 기본적으로 비활성화

4. microsoft/minecraft-samples — 공식 튜토리얼 및 프로젝트 샘플

소스 정의는 config/sources.json에 있습니다.

개발

요구 사항:

• Node.js 24.x

• npm

의존성 설치:

npm install

검사 실행:

npm run check

개발 서버 시작:

npm run dev -- serve

안전한 기본 바인드는 로컬 전용입니다:

http://127.0.0.1:8080/mcp

상태 확인:

GET http://127.0.0.1:8080/health

환경 변수는 .env.example에 문서화되어 있습니다.

현재 CLI

bedrock-mcp serve
bedrock-mcp version
bedrock-mcp help

관리용 수집/인덱스 명령은 이후 마일스톤에서 추가될 예정이며, 공개 MCP 도구로 노출되지 않습니다.

리포지토리 데이터 정책

다음 항목은 로컬에서 생성/배포되며 Git에서 무시됩니다:

• SQLite 인덱스

• SQLite WAL/SHM 파일

• 복제된 업스트림 지식 소스

• 임시 수집 파일

• 백업

• 로그

knowledge/local/는 이후 리포지토리에 의도적으로 추가될 선별된 로컬 소스 자료를 위해 예약되어 있습니다.

라이선스

아직 프로젝트 라이선스가 선택되지 않았습니다.