MTA:SA Documentation MCP Server
Servidor MCP de documentación de MTA:SA
Un servidor MCP (Model Context Protocol) que proporciona a los asistentes de IA acceso fiable y estructurado a la documentación de Multi Theft Auto: San Andreas.
Combina búsqueda rápida por palabras clave, coincidencia semántica y almacenamiento en caché respaldado por SQLite para que los agentes puedan descubrir las API correctas y obtener documentación autorizada sin necesidad de extraer datos de la wiki manualmente.
Aspectos destacados
11 herramientas MCP para descubrimiento, recuperación de documentos, operaciones de caché y guía de flujo de trabajo
Descubrimiento basado en eventos (
search_events,find_events_for_task)Coincidencia semántica de tareas con búsqueda vectorial en SQLite
Expansión inteligente de palabras clave (por ejemplo,
database-> APIdb*)Detección y advertencias de obsolescencia integradas
Caché local de SQLite con tiempo de vida configurable
Puertas de verificación de CI, pruebas de humo y automatización de lanzamientos
Related MCP server: Documentation Retrieval MCP Server (DOCRET)
Instalación
Requisitos:
Node.js 24+
Bun 1.3+ (entorno de ejecución opcional)
pnpm 10+ (para desarrollo local)
Nota sobre el lanzador:
Puede lanzar/instalar mediante flujos de estilo
npx,pnpx,bunxo yarn dlx.El soporte de tiempo de ejecución es multiplataforma: Node.js (vía
node:sqlite) y Bun (víabun:sqlite).
Desde npm (recomendado)
npm install -g mtasa-docs-mcpo:
pnpm add -g mtasa-docs-mcpInstalación rápida

Desde el código fuente
git clone https://github.com/Luminaire1337/mtasa-docs-mcp.git
cd mtasa-docs-mcp
pnpm install
pnpm buildSi su entorno omite las dependencias nativas opcionales, ejecute:
pnpm install --forceConfiguración del cliente MCP
Cursor (manual)
Global: ~/.cursor/mcp.json
Proyecto: .cursor/mcp.json
{
"mcpServers": {
"mtasa-docs": {
"command": "npx",
"args": ["-y", "mtasa-docs-mcp"]
}
}
}VS Code (manual)
Espacio de trabajo: .vscode/mcp.json
Usuario: Paleta de comandos -> MCP: Open User Configuration
{
"servers": {
"mtasa-docs": {
"command": "npx",
"args": ["-y", "mtasa-docs-mcp"]
}
}
}O añádalo desde la terminal:
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 (manual)
Archivo de configuración global: ~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"mtasa-docs": {
"type": "local",
"command": ["npx", "-y", "mtasa-docs-mcp"],
"enabled": true
}
}
}Antigravity (manual)
Archivo de configuración: ~/.gemini/antigravity/mcp_config.json
{
"mcpServers": {
"mtasa-docs": {
"command": "npx",
"args": ["-y", "mtasa-docs-mcp"]
}
}
}Clientes MCP genéricos (manual)
{
"mcpServers": {
"mtasa-docs": {
"command": "node",
"args": ["/absolute/path/to/mtasa-docs-mcp/build/index.js"]
}
}
}Si mtasa-docs-mcp ya está publicado, reemplace el comando por:
{
"mcpServers": {
"mtasa-docs": {
"command": "npx",
"args": ["-y", "mtasa-docs-mcp"]
}
}
}Herramientas disponibles
search_functionssearch_eventsfind_functions_for_taskfind_events_for_taskget_function_docsget_multiple_function_docsget_function_exampleslist_functions_by_categoryget_cache_statsrecommend_doc_workflowclear_cache
Desarrollo
pnpm build
pnpm test
pnpm test:runtime
pnpm smoke
pnpm smoke:cross-runtime
pnpm verify
pnpm verify:fullComprobaciones útiles:
pnpm check:versions- mantiene alineadas las versiones depackage.jsony del servidor MCPpnpm check:changelog- asegura queCHANGELOG.mdtenga el encabezado de la versión actualpnpm check:tool-names- evita regresiones en los nombres de herramientas heredadaspnpm test:runtime- ejecuta pruebas de integración en tiempo de ejecución para las rutas de humo de Node y Bunpnpm smoke:cross-runtime- ejecuta comprobaciones de humo en los entornos de ejecución de Node y Bun
Los scripts se encuentran en scripts/ (compilación, humo, protecciones de lanzamiento).
Flujo de lanzamiento
La automatización del lanzamiento se gestiona mediante .github/workflows/release.yml.
Incremente la versión en
package.jsonysrc/index.ts.Mueva las notas de la versión de
Unreleaseda una sección versionada enCHANGELOG.mdusando## [x.y.z] - YYYY-MM-DD.Cree y envíe una etiqueta de lanzamiento:
git tag v<version> && git push origin v<version>.
Política de ramificación:
Antes de
v1.0.0: se permiten envíos directos amaster.A partir de
v1.0.0: utilice desarrollo basado en PR para todos los cambios enmaster.
En los envíos de etiquetas de lanzamiento (v*.*.*), el flujo de trabajo de lanzamiento:
comprueba si la versión ya existe en npm
ejecuta
pnpm verify:fullpublica en npm con procedencia utilizando publicación confiable (OIDC)
publica
server.jsonen el Registro MCP utilizando GitHub OIDCcrea/actualiza el lanzamiento de GitHub desde
CHANGELOG.mdverifica la instalabilidad del paquete publicado y ejecuta pruebas de humo
Configuración del mantenedor para publicación confiable en npm
En la configuración del paquete npm, configure un editor confiable para este repositorio y flujo de trabajo:
Repositorio:
Luminaire1337/mtasa-docs-mcpArchivo de flujo de trabajo:
.github/workflows/release.ymlEntorno (si se usa): coincida con su configuración de GitHub Actions
Configuración del mantenedor para publicación en el Registro MCP
Asegúrese de que
server.jsonexista en la raíz del repositorio y utilice este nombre de paquete:mtasa-docs-mcpConfigure la propiedad del Registro MCP para
io.github.Luminaire1337/mtasa-docs-mcpEl flujo de trabajo de lanzamiento utiliza
mcp-publisher login github-oidcy publica solo cuando se supera la puerta de publicación de npm
Flujos de trabajo de CI
.github/workflows/ci.yml- verificación en push/PR amaster(Ubuntu + macOS) y pruebas opcionales de integración con la wiki en vivo en PR etiquetados.github/workflows/release.yml- publicación automatizada y lanzamiento en GitHub en etiquetas de lanzamiento (v*.*.*)
Documentación del proyecto
AGENTS.md- arquitectura y guía para colaboradoresFEATURES.md- hoja de ruta e ideasCHANGELOG.md- historial de lanzamientosSECURITY.md- política de divulgación de vulnerabilidades
Licencia
GNU General Public License v3.0. Consulte 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