Skip to main content
Glama
mcintalmo
by mcintalmo

godot-docs-mcp

CI Build index

MCP-сервер, который предоставляет документацию Godot Engine ИИ-агентам для написания кода.

Godot недостаточно представлен в обучающих данных LLM по сравнению с Unity и Unreal, поэтому агенты регулярно галлюцинируют GDScript API, выдумывают имена узлов и применяют идиомы Godot 3.x к проектам 4.x. Этот сервер опирает их на реальную документацию: полнотекстовый поиск по руководству и учебным пособиям, а также структурированный справочник классов, построенный на основе собственных метаданных API движка.

Построен на ревизии спецификации MCP 2026-07-28 через официальный mcp Python SDK v2, который также обслуживает все более ранние ревизии протокола с того же сервера.

Статус: в разработке. Сервер, его инструменты и ресурсы, командная строка и еженедельный рабочий процесс, публикующий индекс, — всё работает, и опубликован готовый индекс для Godot 4.7, так что sync устанавливает его без сборки. На PyPI пока нет — устанавливайте из git, как указано ниже. Упаковка в виде плагина Claude Code с навыками — более поздний этап.

How it works

Документация индексируется офлайн в единую базу данных SQLite, поэтому поиск быстрый и работает без сетевого соединения.

Содержимое

Источник

Зачем

Руководство, учебные пособия, начало работы

godotengine/godot-docs .rst

Авторские тексты

Справочник классов

godotengine/godot doc/classes/*.xml

Структурирован и типизирован — страницы классов .rst генерируются из этих файлов, поэтому XML даёт точные сигнатуры, а не прозу

docs.godotengine.org находится за Cloudflare-челленджем, отклоняющим не-браузерные клиенты, поэтому отрендеренный сайт не используется как источник. Всё берётся с GitHub.

Related MCP server: Godot MCP Documentation Server

Getting started

Установите готовый индекс. Это одна загрузка около 8 МБ, и её нужно выполнить только один раз для каждой версии Godot.

uvx --from git+https://github.com/mcintalmo/godot-docs-mcp godot-docs-mcp sync
uvx --from git+https://github.com/mcintalmo/godot-docs-mcp godot-docs-mcp status

Затем укажите клиенту на него. Для Claude Code:

claude mcp add godot-docs -- \
  uvx --from git+https://github.com/mcintalmo/godot-docs-mcp godot-docs-mcp

Нет опубликованного индекса для нужной версии или работаете над парсерами? Соберите его из исходников. Для этого нужен git, и это займёт около минуты:

uvx --from git+https://github.com/mcintalmo/godot-docs-mcp godot-docs-mcp sync --rebuild

Спросите что-то, в чём модель стабильно ошибается — «какая правильная сигнатура 4.x для move_and_slide?» — и ответ должен прийти от get_godot_class_member как bool move_and_slide(), без аргументов. В Godot 3.x она принимала несколько аргументов, и именно это помнит большинство обучающих данных.

Commands

Команда

Назначение

godot-docs-mcp

Обслуживание через stdio. Именно так его запускает клиент; serve используется по умолчанию

godot-docs-mcp sync

Скачать готовый индекс. --rebuild вместо этого собирает его из исходников

godot-docs-mcp status

Что проиндексировано, из чего собрано и не отстало ли оно. --json для скриптов

godot-docs-mcp search "how do I make a character jump"

Прогнать запрос через тот же код, что используют инструменты, и вывести ранжирование

godot-docs-mcp package

Записать релизные артефакты для установленного индекса. Для сборочного рабочего процесса

Каждый параметр также является переменной окружения с префиксом GODOT_DOCS_MCP_ — полную таблицу см. в config.py.

Staying current

Документация меняется без предупреждения, поэтому за ней независимо следят две вещи.

Еженедельный рабочий процесс проверяет, сдвинулись ли коммиты в апстриме, и если да, пересобирает индекс, прогоняет по всему корпусу запросы, чтобы убедиться, что он отвечает, и публикует его как релизный артефакт. godot-docs-mcp sync — это то, как он доходит до вас.

Запущенный сервер раз в день в фоне проверяет, не опубликован ли более новый индекс. Он никогда не скачивает его — индекс, который отстаёт, по-прежнему правильно отвечает для той версии, из которой он собран, и заменять его решаете вы. Вместо этого он сообщает об этом: в godot://status и однострочным notice в результатах поиска. Если проверка не может выполниться, ответ — «не удалось проверить», а не «актуально».

Tools

Каждый инструмент доступен только для чтения, и каждый ответ ограничен по размеру, чтобы один вызов не вытеснил разговор, который он должен был информировать. Обрезанный ответ сообщает об этом и называет вызов, который вернёт остальное.

Инструмент

Назначение

search_godot_docs

Ранжированный поиск по руководству, учебным пособиям и справочнику классов. Работают вопросы на простом языке

fetch_godot_doc

Страница или отдельный раздел страницы

get_godot_class

Цепочка наследования плюс карта сигнатур для класса — без прозы, поэтому запись класса на 300 КБ остаётся доступной для ответа

get_godot_class_member

Точная сигнатура и полное описание одного члена

search_godot_code_examples

Фрагменты GDScript и C# с указанием страницы и заголовка, откуда они взяты

Resources

URI

Содержимое

godot://status

Индексированная версия, счётчики и коммиты апстрима, из которых она собрана

godot://index

Карта корпуса: что в нём есть, как к нему обращаться, какой инструмент вызывать

godot://doc/{path}, godot://doc/{path}#{anchor}

Страница или один её раздел

godot://class/{name}, godot://class/{name}#{member}

Класс или один его член

515 страниц и 1078 классов намеренно не перечислены в resources/list. Шаблоны — это URI, которые уже возвращает каждый инструмент, так что по результату поиска хост может перейти без дополнительного вызова инструмента.

Development

Требуется uv.

uv sync --dev
uv run pre-commit install

Команда

Назначение

uv run pytest

Модульные тесты (герметичные — без сети)

uv run pytest -m slow

Интеграционные тесты против реального индекса

uv run ruff check --fix && uv run ruff format

Линтинг и форматирование

uv run ty check

Проверка типов

uv run pre-commit run --all-files

Всё, что выполняет CI-задача линтинга

Об архитектуре и правилах внесения вклада см. CLAUDE.md.

License

MIT. Сама документация Godot лицензирована CC BY 4.0 Juan Linietsky, Ariel Manzur и сообществом Godot; этот проект распространяет её в индексированной форме и не изменяет эту лицензию.

Install Server
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to search and retrieve information from the official Godot game engine documentation. Provides tools to search documentation, get page content, and access detailed class information.
    24
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Provides AI assistants with direct access to the complete Godot Engine documentation, including classes, tutorials, and features. It enables developers to retrieve and analyze official documentation through natural language interfaces using the Model Context Protocol.
    2
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides AI assistants with access to the complete Godot Engine documentation, enabling developers to get answers about Godot classes, tutorials, and features directly in their chat interface.
    69
    MIT

View all related MCP servers

Related MCP Connectors

  • Provide your AI coding tools with token-efficient access to up-to-date technical documentation for…

  • Search @imqueue docs and scaffold typed services & clients from your AI coding agent.

  • An MCP server that gives your AI access to the source code and docs of all public github repos

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mcintalmo/godot-docs-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server