Skip to main content
Glama
mcintalmo
by mcintalmo

godot-docs-mcp

CI Build index

Godot Engine 문서를 AI 코딩 에이전트에 제공하는 MCP 서버입니다.

Godot은 Unity나 Unreal에 비해 LLM 학습 데이터에 충분히 포함되어 있지 않아서, 에이전트가 GDScript API를 자주 환각(hallucinate)하거나, 노드 이름을 지어내거나, Godot 3.x 관용구를 4.x 프로젝트에 적용하곤 합니다. 이 서버는 실제 문서에 기반을 둡니다. 매뉴얼과 튜토리얼에 대한 전문(full-text) 검색과, 엔진 자체의 API 메타데이터로 구축된 구조화된 클래스 레퍼런스를 제공합니다.

공식 mcp Python SDK v2를 통해 MCP 사양 개정판 2026-07-28을 기반으로 구축되었으며, 동일한 서버에서 모든 이전 프로토콜 개정판도 함께 제공합니다.

상태: 개발 중. 서버, 도구와 리소스, 명령줄, 인덱스를 게시하는 주간 워크플로우는 모두 작동하며, Godot 4.7용 사전 빌드 인덱스가 게시되어 있어 sync를 실행하면 빌드 없이 설치됩니다. 아직 PyPI에는 없습니다. 아래와 같이 git에서 설치하세요. 스킬을 포함한 Claude Code 플러그인으로 패키징하는 것은 이후 단계입니다.

작동 방식

문서는 오프라인에서 단일 SQLite 데이터베이스로 인덱싱되므로 조회가 빠르고 네트워크 연결 없이도 작동합니다.

콘텐츠

소스

이유

매뉴얼, 튜토리얼, 시작하기

godotengine/godot-docs .rst

작성된 산문(prose)

클래스 레퍼런스

godotengine/godot doc/classes/*.xml

구조화되고 타입이 지정됨 — .rst 클래스 페이지는 이 XML에서 생성되므로, XML은 산문이 아닌 정확한 시그니처를 제공합니다.

docs.godotengine.org는 Cloudflare 챌린지 뒤에 있어 비브라우저 클라이언트를 거부하므로, 렌더링된 사이트는 소스로 사용되지 않습니다. 모든 것은 GitHub에서 가져옵니다.

Related MCP server: Godot MCP Documentation Server

시작하기

사전 빌드 인덱스를 설치하세요. 약 8MB의 다운로드 한 번이며, 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이 필요하며 약 1분이 걸립니다:

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

모델이 확실히 틀리는 질문을 해보세요 — "move_and_slide의 올바른 4.x 시그니처는 무엇인가요?" — 그러면 get_godot_class_member에서 인수 없이 bool move_and_slide()로 답이 돌아와야 합니다. Godot 3.x에서는 인수가 여러 개였으며, 대부분의 학습 데이터가 기억하는 것이 바로 그 버전입니다.

명령어

명령어

용도

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를 참조하세요.

최신 상태 유지

문서는 예고 없이 변경되므로, 두 가지가 독립적으로 이를 추적합니다.

주간 워크플로우는 업스트림 커밋이 이동했는지 확인하고, 이동했다면 인덱스를 재빌드하고, 전체 말뭉치를 쿼리하여 답변을 확인한 후 릴리스 자산으로 게시합니다. godot-docs-mcp sync가 이를 사용자에게 전달하는 방법입니다.

실행 중인 서버는 하루에 한 번 백그라운드에서 새 인덱스가 게시되었는지 확인합니다. 절대 다운로드하지 않습니다. 지연된 인덱스도 빌드된 버전에 대해서는 여전히 정확하게 답변하며, 교체 여부는 사용자의 결정입니다. 대신 서버가 하는 일은 이를 알리는 것입니다. godot://status에서, 그리고 검색 결과에 한 줄 notice로 표시합니다. 확인이 실행될 수 없으면 답은 "확인할 수 없음"이며, 절대 "최신 상태"가 아닙니다.

도구

모든 도구는 읽기 전용이며, 모든 응답은 한 번의 호출이 알리려던 대화를 압도하지 않도록 상한이 있습니다. 잘린 응답은 그 사실을 알리고, 나머지를 반환하는 호출을 명시합니다.

도구

용도

search_godot_docs

매뉴얼, 튜토리얼, 클래스 레퍼런스에 대한 순위 검색. 평문 질문도 작동합니다.

fetch_godot_doc

페이지 또는 페이지의 단일 섹션

get_godot_class

클래스의 상속 체인과 시그니처 맵 — 산문이 없으므로 300KB 클래스 항목도 답변 가능합니다.

get_godot_class_member

단일 멤버의 정확한 시그니처와 전체 설명

search_godot_code_examples

GDScript 및 C# 스니펫, 출처 페이지와 제목 포함

리소스

URI

콘텐츠

godot://status

인덱싱된 버전, 개수, 빌드된 업스트림 커밋

godot://index

말뭉치의 지도: 무엇을 담고 있는지, 어떻게 주소를 지정하는지, 어떤 도구를 호출할지

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

페이지 또는 그 섹션 하나

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

클래스 또는 그 멤버 하나

515개 페이지와 1,078개 클래스는 의도적으로 resources/list에 열거되지 않습니다. 템플릿은 모든 도구가 이미 반환하는 URI이므로, 검색 결과는 추가 도구 호출 없이 호스트가 바로 따라갈 수 있습니다.

개발

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를 참조하세요.

라이선스

MIT. Godot 문서 자체는 Juan Linietsky, Ariel Manzur 및 Godot 커뮤니티가 CC BY 4.0으로 라이선스합니다. 이 프로젝트는 문서의 인덱싱된 형태를 재배포하며 해당 라이선스를 변경하지 않습니다.

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