Tachikoma Game Design MCP

本地只读 MCP 服务器，供 Claude 查询关于叙事和电子游戏设计的 Chroma 库。此仓库仅包含公共运行时；提取、分块和嵌入生成位于 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 或分发基于受版权保护材料创建的索引。