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やインデックスを許可なく公開したり配布したりしないでください。