Tachikoma Game Design MCP

Lokaler, schreibgeschützter MCP-Server, mit dem Claude eine Chroma-Bibliothek zu Videospiel-Narrativ und -Design abfragen kann. Dieses Repository enthält nur die öffentliche Runtime; Extraktion, Chunks und Embedding-Generierung befinden sich in tachikoma-rag-infra.

Funktionen

• Mehrsprachige semantische Suche mit BAAI/bge-m3.

• Ergebnisse mit Buch, Seite, Text und Ähnlichkeit.

• MCP-Transport über stdio, keine offenen Ports.

• Offline-Betrieb mit einem zuvor heruntergeladenen Modell.

• Schreibgeschützte Tools und Schutz vor eingebetteten Anweisungen.

• Konfigurierbarer Index-Pfad, ohne Bindung an die Infrastruktur.

Related MCP server: Project RAG wiki

Inhalt

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.

Die PDFs, Texte, Chunks, Embeddings und Chroma-Datenbanken sind nicht Teil dieses öffentlichen Repositorys.

Installation

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

Bereitstellen eines Index

Tachikoma benötigt eine Chroma-Sammlung, die mit demselben Embedding-Modell erstellt wurde. Du kannst sie über das private Repository tachikoma-rag-infra generieren oder über einen autorisierten Kanal erhalten.

Verfügbare Variablen:

Das Modell muss vor dem Start des MCP im lokalen Cache heruntergeladen sein. Der Server verwendet local_files_only=True und lädt während einer Konversation keine Dateien herunter.

Das Log ist rotierend, speichert keinen Abfragetext und zeichnet Ladezeiten des Modells, Chroma-Verbindung, Embedding, Vektorsuche und Gesamtausführung auf.

Claude Desktop konfigurieren

1. Kopiere den Eintrag aus claude_desktop_config.example.json in mcpServers.

2. Ersetze die Pfade für Repository, Python und Chroma.

3. Schließe Claude Desktop vollständig und öffne es erneut.

Unter Windows befindet sich die Konfiguration normalerweise unter:

%APPDATA%\Claude\claude_desktop_config.json

Werkzeuge

• search_narrative_library: semantische Suche mit optionalem Filter nach Buch.

• read_book_page: ruft die Chunks einer Seite in Reihenfolge ab.

• list_library_books: listet die indexierten Bücher auf.

• library_status: prüft Modell, Sammlung und Anzahl der Chunks.

Tests

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

Optionale statische Analyse:

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

Datenschutz

Der Index kann Dokumentfragmente enthalten. Veröffentliche kein Chroma und verteile keine Indizes, die aus urheberrechtlich geschütztem Material erstellt wurden, ohne Genehmigung.