MTA:SA Documentation MCP Server
MTA:SA 문서화 MCP 서버
AI 어시스턴트에게 Multi Theft Auto: San Andreas 문서에 대한 신뢰할 수 있고 구조화된 액세스를 제공하는 MCP(Model Context Protocol) 서버입니다.
빠른 키워드 검색, 의미론적 매칭, SQLite 기반 캐싱을 결합하여 에이전트가 수동으로 위키를 긁어올 필요 없이 올바른 API를 찾고 공식 문서를 가져올 수 있도록 합니다.
주요 기능
검색, 문서 가져오기, 캐시 작업 및 워크플로우 안내를 위한 11개의 MCP 도구
이벤트 우선 검색 (
search_events,find_events_for_task)SQLite 벡터 검색을 통한 의미론적 작업 매칭
스마트 키워드 확장 (예:
database->db*API)내장된 지원 중단 감지 및 경고
구성 가능한 수명을 가진 로컬 SQLite 캐시
CI 검증 게이트, 스모크 테스트 및 릴리스 자동화
Related MCP server: Documentation Retrieval MCP Server (DOCRET)
설치
요구 사항:
Node.js 24+
Bun 1.3+ (선택적 런타임)
pnpm 10+ (로컬 개발용)
런처 참고:
npx,pnpx,bunx또는 yarn dlx 스타일의 흐름을 통해 실행/설치할 수 있습니다.런타임 지원은 교차 런타임입니다: Node.js (
node:sqlite사용) 및 Bun (bun:sqlite사용).
npm에서 설치 (권장)
npm install -g mtasa-docs-mcp또는:
pnpm add -g mtasa-docs-mcp빠른 설치

소스에서 설치
git clone https://github.com/Luminaire1337/mtasa-docs-mcp.git
cd mtasa-docs-mcp
pnpm install
pnpm build환경에서 선택적 네이티브 종속성을 건너뛰는 경우 다음을 실행하세요:
pnpm install --forceMCP 클라이언트 설정
Cursor (수동)
전역: ~/.cursor/mcp.json
프로젝트: .cursor/mcp.json
{
"mcpServers": {
"mtasa-docs": {
"command": "npx",
"args": ["-y", "mtasa-docs-mcp"]
}
}
}VS Code (수동)
워크스페이스: .vscode/mcp.json
사용자: 명령 팔레트 -> MCP: Open User Configuration
{
"servers": {
"mtasa-docs": {
"command": "npx",
"args": ["-y", "mtasa-docs-mcp"]
}
}
}또는 터미널에서 추가:
code --add-mcp "{\"name\":\"mtasa-docs\",\"command\":\"npx\",\"args\":[\"-y\",\"mtasa-docs-mcp\"]}"Claude Code (CLI)
claude mcp add-json mtasa-docs '{"type":"stdio","command":"npx","args":["-y","mtasa-docs-mcp"]}'OpenCode (수동)
전역 구성 파일: ~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"mtasa-docs": {
"type": "local",
"command": ["npx", "-y", "mtasa-docs-mcp"],
"enabled": true
}
}
}Antigravity (수동)
구성 파일: ~/.gemini/antigravity/mcp_config.json
{
"mcpServers": {
"mtasa-docs": {
"command": "npx",
"args": ["-y", "mtasa-docs-mcp"]
}
}
}일반 MCP 클라이언트 (수동)
{
"mcpServers": {
"mtasa-docs": {
"command": "node",
"args": ["/absolute/path/to/mtasa-docs-mcp/build/index.js"]
}
}
}mtasa-docs-mcp가 이미 게시된 경우 명령어를 다음으로 교체하세요:
{
"mcpServers": {
"mtasa-docs": {
"command": "npx",
"args": ["-y", "mtasa-docs-mcp"]
}
}
}사용 가능한 도구
search_functionssearch_eventsfind_functions_for_taskfind_events_for_taskget_function_docsget_multiple_function_docsget_function_exampleslist_functions_by_categoryget_cache_statsrecommend_doc_workflowclear_cache
개발
pnpm build
pnpm test
pnpm test:runtime
pnpm smoke
pnpm smoke:cross-runtime
pnpm verify
pnpm verify:full유용한 확인 사항:
pnpm check:versions-package.json과 MCP 서버 버전 일치 유지pnpm check:changelog-CHANGELOG.md에 현재 릴리스 제목이 있는지 확인pnpm check:tool-names- 레거시 도구 명명 회귀 방지pnpm test:runtime- Node 및 Bun 스모크 경로에 대한 통합 런타임 테스트 실행pnpm smoke:cross-runtime- Node 및 Bun 런타임 모두에 대해 스모크 검사 실행
스크립트는 scripts/ (빌드, 스모크, 릴리스 가드)에 위치합니다.
릴리스 흐름
릴리스 자동화는 .github/workflows/release.yml에서 처리됩니다.
package.json및src/index.ts에서 버전을 올립니다.CHANGELOG.md의Unreleased에서 버전이 지정된 섹션으로 릴리스 노트를 이동합니다 (## [x.y.z] - YYYY-MM-DD사용).릴리스 태그를 생성하고 푸시합니다:
git tag v<version> && git push origin v<version>.
브랜치 정책:
v1.0.0이전:master로 직접 푸시가 허용됩니다.v1.0.0부터:master에 대한 모든 변경 사항에 대해 PR 기반 개발을 사용합니다.
릴리스 태그 푸시(v*.*.*) 시 릴리스 워크플로우는 다음을 수행합니다:
npm에 버전이 이미 존재하는지 확인
pnpm verify:full실행신뢰할 수 있는 게시(OIDC)를 사용하여 출처와 함께 npm에 게시
GitHub OIDC를 사용하여 MCP 레지스트리에
server.json게시CHANGELOG.md에서 GitHub 릴리스 생성/업데이트게시된 패키지의 설치 가능 여부 확인 및 스모크 테스트 실행
npm 신뢰할 수 있는 게시를 위한 관리자 설정
npm 패키지 설정에서 이 저장소 및 워크플로우에 대한 신뢰할 수 있는 게시자를 구성하세요:
저장소:
Luminaire1337/mtasa-docs-mcp워크플로우 파일:
.github/workflows/release.yml환경(사용하는 경우): GitHub Actions 구성과 일치시킵니다.
MCP 레지스트리 게시를 위한 관리자 설정
저장소 루트에
server.json이 존재하고 다음 패키지 이름을 사용하는지 확인하세요:mtasa-docs-mcpio.github.Luminaire1337/mtasa-docs-mcp에 대한 MCP 레지스트리 소유권을 구성하세요.릴리스 워크플로우는
mcp-publisher login github-oidc를 사용하며 npm 게시 게이트를 통과할 때만 게시합니다.
CI 워크플로우
.github/workflows/ci.yml-master로 푸시/PR 시 검증 (Ubuntu + macOS) 및 레이블이 지정된 PR에 대한 선택적 라이브 위키 통합 테스트.github/workflows/release.yml- 릴리스 태그(v*.*.*) 시 자동 게시 및 GitHub 릴리스
프로젝트 문서
AGENTS.md- 아키텍처 및 기여자 가이드FEATURES.md- 로드맵 및 아이디어CHANGELOG.md- 릴리스 기록SECURITY.md- 취약점 공개 정책
라이선스
GNU General Public License v3.0. LICENSE를 참조하세요.
Available Tools
11 toolsclear_cacheB
Clear the MTA:SA documentation cache for a specific function or all functions.
Inputs: function_name (required).
find_events_for_taskA
Task-to-events matcher. Use when you need event names for handlers/triggers (e.g., resource lifecycle, player joins, marker hits). Returns ranked MTA:SA events only.
Inputs: task_description (required), side, limit.
find_functions_for_taskA
Task-to-functions matcher. Use this FIRST when user intent is high-level (e.g., 'vehicle dealership', 'login panel'). Returns ranked MTA:SA functions/events optimized for follow-up documentation retrieval.
Inputs: task_description (required), limit.
get_cache_statsB
Get statistics about the MTA:SA documentation cache.
Inputs: no named parameters.
get_function_docsA
Fetch authoritative docs for exactly ONE MTA:SA function/event by canonical name. Preferred over manual web browsing. For multiple names, use get_multiple_function_docs in one call.
Inputs: function_name (required), use_cache, include_optional_arguments.
get_function_examplesA
Get only code examples for one function/event after docs lookup. Use when writing implementation snippets and tests.
Inputs: function_name (required).
get_multiple_function_docsA
Batch docs retrieval for implementation phase. Provide exact function/event names (ideally from search/find tools) and get combined authoritative docs in one response.
Inputs: function_names (required), include_examples, include_optional_arguments.
list_functions_by_categoryA
Enumerate canonical function/event names in a category. Useful for discovery when query terms are vague.
Inputs: category (required), limit.
recommend_doc_workflowA
Planner tool that tells LLMs exactly which mtasa-docs tools to call next for a given task. Use this to enforce MCP-first workflows and avoid manual wiki scraping.
Inputs: task_description (required), known_function_names.
search_eventsA
Event discovery tool. Search MTA:SA client/server events only (not regular functions), then chain into docs tools with exact event names.
Inputs: query (required), side, limit.
search_functionsA
Primary discovery tool. Search MTA:SA functions and events by name or keyword before coding. Returns canonical function names with side/category so LLMs can reliably chain into docs tools.
Inputs: query (required), side, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose: search tools (search_functions, search_events) differ from task matchers (find_functions_for_task, find_events_for_task), retrieval tools handle single/batch/examples, and cache/listing/planner serve unique roles. No overlap or confusion.
All tool names follow a consistent verb_noun snake_case pattern (e.g., clear_cache, search_functions, get_function_docs). No mixing of cases or verb styles, making the pattern predictable and easy to navigate.
With 11 tools, the server is well-scoped for its documentation purpose. Each tool earns its place, covering search, retrieval, cache management, category listing, and workflow planning without excess or deficiency.
The tool surface provides a complete workflow: discover (search/task matchers), retrieve (docs, examples, batch), manage (cache stats/clear), explore (category listing), and plan (workflow recommender). No obvious gaps for a documentation server.
Maintenance
Related MCP Connectors
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
An MCP server that gives your AI access to the source code and docs of all public github repos
An MCP server that integrates with Discord to provide AI-powered features.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context20 npm263MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to access up-to-date documentation for Python libraries like LangChain, LlamaIndex, and OpenAI through dynamic fetching from official sources.1MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides full-text search over documentation using Whoosh, enabling AI assistants to find up-to-date, authoritative answers.MIT
- AlicenseAqualityDmaintenanceAn MCP server that serves documentation and enables AI-powered search, Q\&A, and document analysis for developer tools and guides.54MIT