unity-manual-mcp
Unity Manual MCP
Локальный MCP-сервер (stdio), который предоставляет локально установленную документацию Unity вашему ИИ-ассистенту.
Папка документации обычно находится в каталоге установки Unity Editors, в подпапке Data\Documentation\en.
Manual/— статьи с инструкциями, организованные по главам (~3.5k страниц)ScriptReference/— полный справочник по скриптовому API, по одной странице на класс / свойство / метод (~42k страниц)
При первом запуске сервер создаёт полнотекстовый индекс SQLite для каждой страницы (извлечение тела статьи в стиле Mozilla-Readability, удаление шаблонной информации, сохранение примеров кода) и кэширует его во временный каталог ОС. Последующие запуски используют его повторно; он автоматически пересоздаётся, если количество файлов документации меняется.
Требования
Python 3.10+ — указано в
pyproject.toml(требуетсяfastmcp3.x). uv использует любой уже установленный Python, удовлетворяющий этому условию, и загружает новый только в том случае, если совместимого интерпретатора нет.
Related MCP server: unity-kb-mcp
Настройка
Склонируйте репозиторий
Откройте терминал в клонированном репозитории
Выполните
uv syncСоздаёт .venv и устанавливает зависимости из pyproject.toml.
Запуск
uv run server.py "C:\Program Files\Unity\Hub\Editor\<ver>\Editor\Data\Documentation\en"Папка en определяется автоматически, если указать ...\Documentation или ...\Editor\Data.
Флаги:
--selftest— создать индекс и выполнить пробные запросы, затем выйти (без MCP-сервера; удобно для проверки новой установки)--rebuild— принудительно пересоздать индекс--prune— удалить устаревшие записи кэша (отсутствует файл db) из манифестаUNITY_DOCS_PATHпеременная окружения — альтернатива позиционному аргументу
ℹ После свежей установки запустите сервер вручную один раз, чтобы предварительно проиндексировать документацию и избежать ожидания при первом использовании
uv run server.py --selftest "C:\Program Files\Unity\Hub\Editor\<ver>\Editor\Data\Documentation\en"
Добавление MCP-сервера
Это stdio-сервер, поэтому подойдёт любой клиент, который может запускать локальный процесс. Каждый клиент выполняет одну и ту же команду:
uv run --directory "<repo>" server.py "<docs path>"где <repo> — папка этого репозитория, а <docs path> — папка en документации Unity (автоматически определяется, если указать ...\Documentation или ...\Editor\Data). uv run автоматически создаёт и синхронизирует окружение .venv, поэтому клиенту нужен только uv в PATH.
Claude Desktop
claude_desktop_config.json (укажите свои собственные пути):
{
"mcpServers": {
"unity-manual": {
"command": "uv",
"args": ["run", "--directory", "<repo>", "server.py", "<docs path>"]
}
}
}Claude Code
claude mcp add unity-manual -- uv run --directory "<repo>" server.py "<docs path>"OpenCode
opencode.json в проекте или глобальный конфиг
(~/.config/opencode/opencode.json):
{
"mcp": {
"unity-manual": {
"type": "local",
"command": ["uv", "run", "--directory", "<repo>", "server.py", "<docs path>"],
"enabled": true
}
}
}Codex
codex mcp add unity-manual -- uv run --directory "<repo>" server.py "<docs path>"Или отредактируйте ~/.codex/config.toml (общий с настольным приложением ChatGPT и расширением IDE; проектный .codex/config.toml работает в доверенных проектах):
[mcp_servers.unity-manual]
command = "uv"
args = ["run", "--directory", "<repo>", "server.py", "<docs path>"]Инструменты
Все доступны только для чтения (readOnlyHint):
Инструмент | Назначение |
| Полнотекстовый поиск (всё / manual / api) |
| Прочитать одну страницу в виде чистого текста (путь из результатов поиска) |
| Просматривать главы руководства или страницы внутри главы |
| Найти страницу API класса / члена по имени C# |
Кэш индекса
%TEMP%\unity-manual-mcp\ содержит по одному файлу db для каждого редактора (например, <hash>.db)
плюс manifest.json, сопоставляющий каждый путь к документации с его файлом db. При переключении редакторов
переиспользуется кэшированный индекс; он проверяется по количеству HTML-файлов. Удалите файл db
(или используйте --rebuild), чтобы принудительно пересоздать его. --selftest сообщает об устаревших записях
(отсутствует файл db) и осиротевших записях (папка документации удалена, а db остался);
--prune удаляет устаревшие.
Благодарности
Полностью написано Qwen 3.8 27b 🙂
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for querying Forkast documentation
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
An MCP server for search and retrieval over a local LanceDB database
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceGeneric MCP server that exposes Markdown documentation to LLMs, enabling them to search and answer questions about any software documentation.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP Server that provides Retrieval-Augmented Generation (RAG) capabilities to surface the latest Unity API documentation (currently v6.x).1MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes one or more documentation folders (Markdown, MDX, TXT) to AI agents, enabling listing, reading, and searching of documentation files.-
- AlicenseAqualityBmaintenanceA local MCP server that fetches official library documentation (llms.txt-first), caches it to disk, and serves relevant sections to coding agents offline with deterministic retrieval.37 npmMIT