Tachikoma Game Design MCP

Claude가 비디오 게임 내러티브 및 디자인에 관한 Chroma 라이브러리를 쿼리할 수 있는 로컬 읽기 전용 MCP 서버입니다. 이 저장소에는 공개 런타임만 포함되어 있습니다. 추출, 청크 및 임베딩 생성은 tachikoma-rag-infra에 있습니다.

기능

• BAAI/bge-m3를 사용한 다국어 의미 검색.

• 도서, 페이지, 텍스트 및 유사도 결과.

• 열린 포트 없이 stdio를 통한 MCP 전송.

• 사전 다운로드된 모델로 오프라인 작동.

• 읽기 전용 도구 및 내장 명령어 보호.

• 인프라에 결합되지 않은 구성 가능한 인덱스 경로.

Related MCP server: Project RAG wiki

내용

mcp_server.py                         Servidor MCP.
claude_desktop_config.example.json    Configuración de Claude Desktop.
requirements.txt                      Dependencias de ejecución.
pyrightconfig.json                    Configuración del análisis estático.
tests/test_mcp_server.py               Pruebas del runtime.

PDF, 텍스트, 청크, 임베딩 및 Chroma 기반은 이 공개 저장소의 일부가 아닙니다.

설치

py -3.12 -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt

인덱스 제공

Tachikoma는 동일한 임베딩 모델로 생성된 Chroma 컬렉션이 필요합니다. 비공개 저장소 tachikoma-rag-infra를 통해 생성하거나 권한이 있는 채널을 통해 받을 수 있습니다.

사용 가능한 변수:

모델은 MCP를 시작하기 전에 로컬 캐시에 다운로드되어 있어야 합니다. 서버는 local_files_only=True를 사용하며 대화 중에 파일을 다운로드하지 않습니다.

로그는 순환되며, 쿼리 텍스트를 저장하지 않고 모델 로드 시간, Chroma 연결, 임베딩, 벡터 검색 및 총 실행 시간을 기록합니다.

Claude Desktop 설정

1. claude_desktop_config.example.json의 항목을 mcpServers 내에 복사합니다.

2. 저장소, Python 및 Chroma 경로를 대체합니다.

3. Claude Desktop을 완전히 종료하고 다시 엽니다.

Windows에서 구성은 일반적으로 다음 위치에 있습니다:

%APPDATA%\Claude\claude_desktop_config.json

도구

• search_narrative_library: 선택적 도서 필터를 사용한 의미 검색.

• read_book_page: 페이지의 청크를 순서대로 검색합니다.

• list_library_books: 색인된 도서를 나열합니다.

• library_status: 모델, 컬렉션 및 청크 수를 확인합니다.

테스트

python -m unittest discover -s tests -p "test_*.py"

선택적 정적 분석:

uv tool install basedpyright
basedpyright --pythonpath ".venv\Scripts\python.exe" -p pyrightconfig.json

개인정보 보호

인덱스에는 문서 조각이 포함될 수 있습니다. Chroma를 게시하거나 저작권이 있는 자료로 생성된 인덱스를 허가 없이 배포하지 마십시오.