godot-docs-mcp
godot-docs-mcp
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 데이터베이스로 인덱싱되므로 조회가 빠르고 네트워크 연결 없이도 작동합니다.
콘텐츠 | 소스 | 이유 |
매뉴얼, 튜토리얼, 시작하기 |
| 작성된 산문(prose) |
클래스 레퍼런스 |
| 구조화되고 타입이 지정됨 — |
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에서는 인수가 여러 개였으며, 대부분의 학습 데이터가 기억하는 것이 바로 그 버전입니다.
명령어
명령어 | 용도 |
| stdio로 서빙. 클라이언트가 실행하는 것이며, |
| 사전 빌드 인덱스 다운로드. |
| 무엇이 인덱싱되었는지, 무엇으로 빌드되었는지, 뒤처졌는지 여부. 스크립트용 |
| 도구가 사용하는 것과 동일한 코드로 쿼리를 실행하고 순위를 출력합니다. |
| 설치된 인덱스의 릴리스 자산을 작성. 빌드 워크플로우용. |
모든 설정은 GODOT_DOCS_MCP_ 접두사가 붙은 환경 변수이기도 합니다. 전체 표는 config.py를 참조하세요.
최신 상태 유지
문서는 예고 없이 변경되므로, 두 가지가 독립적으로 이를 추적합니다.
주간 워크플로우는 업스트림 커밋이 이동했는지 확인하고, 이동했다면 인덱스를 재빌드하고, 전체 말뭉치를 쿼리하여 답변을 확인한 후 릴리스 자산으로 게시합니다. godot-docs-mcp sync가 이를 사용자에게 전달하는 방법입니다.
실행 중인 서버는 하루에 한 번 백그라운드에서 새 인덱스가 게시되었는지 확인합니다. 절대 다운로드하지 않습니다. 지연된 인덱스도 빌드된 버전에 대해서는 여전히 정확하게 답변하며, 교체 여부는 사용자의 결정입니다. 대신 서버가 하는 일은 이를 알리는 것입니다. godot://status에서, 그리고 검색 결과에 한 줄 notice로 표시합니다. 확인이 실행될 수 없으면 답은 "확인할 수 없음"이며, 절대 "최신 상태"가 아닙니다.
도구
모든 도구는 읽기 전용이며, 모든 응답은 한 번의 호출이 알리려던 대화를 압도하지 않도록 상한이 있습니다. 잘린 응답은 그 사실을 알리고, 나머지를 반환하는 호출을 명시합니다.
도구 | 용도 |
| 매뉴얼, 튜토리얼, 클래스 레퍼런스에 대한 순위 검색. 평문 질문도 작동합니다. |
| 페이지 또는 페이지의 단일 섹션 |
| 클래스의 상속 체인과 시그니처 맵 — 산문이 없으므로 300KB 클래스 항목도 답변 가능합니다. |
| 단일 멤버의 정확한 시그니처와 전체 설명 |
| GDScript 및 C# 스니펫, 출처 페이지와 제목 포함 |
리소스
URI | 콘텐츠 |
| 인덱싱된 버전, 개수, 빌드된 업스트림 커밋 |
| 말뭉치의 지도: 무엇을 담고 있는지, 어떻게 주소를 지정하는지, 어떤 도구를 호출할지 |
| 페이지 또는 그 섹션 하나 |
| 클래스 또는 그 멤버 하나 |
515개 페이지와 1,078개 클래스는 의도적으로 resources/list에 열거되지 않습니다. 템플릿은 모든 도구가 이미 반환하는 URI이므로, 검색 결과는 추가 도구 호출 없이 호스트가 바로 따라갈 수 있습니다.
개발
uv가 필요합니다.
uv sync --dev
uv run pre-commit install명령어 | 용도 |
| 단위 테스트 스위트 (격리 — 네트워크 없음) |
| 실제 인덱스에 대한 통합 테스트 |
| 린트 및 포맷 |
| 타입 검사 |
| CI 린트 작업이 실행하는 모든 것 |
아키텍처와 기여 규칙은 CLAUDE.md를 참조하세요.
라이선스
MIT. Godot 문서 자체는 Juan Linietsky, Ariel Manzur 및 Godot 커뮤니티가 CC BY 4.0으로 라이선스합니다. 이 프로젝트는 문서의 인덱싱된 형태를 재배포하며 해당 라이선스를 변경하지 않습니다.
Maintenance
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
- AlicenseNot gradedqualityCmaintenanceEnables 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.24MIT
- AlicenseAqualityDmaintenanceProvides 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.2MIT
- AlicenseNot gradedqualityDmaintenanceProvides 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.69MIT
- FlicenseNot gradedqualityCmaintenanceQuery Godot Engine documentation with full-text search across classes, methods, properties, and inheritance.1
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
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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