Skip to content

Tyrus MCP ​

El servidor MCP de Tyrus permite que clientes de IA compatibles busquen la documentación oficial y comprueben código Tyrus independiente con el análisis compartido del compilador. La instalación es automática para los clientes compatibles detectados en la máquina.

Instalación ​

Ejecuta un comando después de instalar Tyrus:

bash
tyrus mcp install

El comando descarga y verifica una caché limitada de la documentación, comprueba el handshake del servidor MCP local y añade una entrada tyrus a los archivos de configuración de los clientes detectados. Se admite la configuración de usuario de Claude Desktop, Cursor, Zed y VS Code Copilot. Se conservan los ajustes existentes, no se sobrescriben las entradas tyrus existentes y los archivos modificados reciben una copia de seguridad antes de la primera edición.

Reinicia o recarga cada cliente configurado. Después, pregunta al asistente sobre Tyrus. El cliente inicia tyrus mcp serve en segundo plano; normalmente no ejecutas ese comando manualmente. Si no se detecta ningún cliente compatible, instala uno y vuelve a ejecutar tyrus mcp install o sigue la configuración manual a continuación.

Comandos ​

ComandoFinalidad
tyrus mcp installDescarga la caché de documentación, configura los clientes detectados y comprueba el handshake del servidor.
tyrus mcp updateActualiza la caché y las entradas administradas por Tyrus en los clientes.
tyrus mcp statusMuestra las versiones de la caché, la configuración de los clientes detectados y los conflictos.
tyrus mcp uninstallElimina las entradas administradas sin cambios y la caché local de documentación.
tyrus mcp serveComando interno del servidor stdio iniciado por un cliente MCP configurado.

Funciones MCP disponibles ​

FunciónDescripción
search_docsBusca títulos indexados y devuelve fragmentos clasificados y enlaces oficiales.
get_pageLee una página completa incluida en el índice de documentación.
check_sourceAnaliza sintaxis, tipos y préstamos de hasta 128 KiB de código independiente en memoria.
tyrus://docs/indexLee el índice de documentación.
tyrus://docs/{path}Lee una página Markdown indexada.
tyrus://llms.txtLee el índice compacto de documentación.
tyrus://llms-full.txtSolicita explícitamente el paquete completo de documentación.
generate_tyrus_codeGuía al modelo para encontrar la documentación actual antes de generar código.
fix_tyrus_codeGuía al modelo para comprobar y corregir código independiente.

search_docs acepta una consulta de hasta 512 bytes UTF-8 y devuelve como máximo 20 resultados. get_page devuelve hasta 1 MiB por página; el recurso de documentación completa está limitado a un paquete descargado de 32 MiB. check_source acepta hasta 128 KiB e interrumpe el análisis después de cinco segundos.

check_source devuelve códigos de diagnóstico estables, niveles de severidad, mensajes, rangos en bytes y posiciones de línea y columna que empiezan en uno. No ejecuta código, crea archivos, lee un proyecto, carga variables de entorno ni resuelve imports relativos al proyecto. Los imports de módulos nativos están disponibles cuando el compilador tiene declaraciones independientes para ellos. El análisis no es un sandbox de seguridad. Los clientes y modelos deciden cuándo llamar a las herramientas MCP, por lo que el servidor no puede garantizar que el asistente compruebe el código o consulte la documentación.

Configuración manual ​

Usa la ruta absoluta del ejecutable de Tyrus en el campo command. Conserva los demás ajustes del archivo. Cursor, Claude Desktop y Copilot usan un objeto mcpServers; Zed usa context_servers.

ClienteUbicación de la configuración del usuarioClave raíz
Claude DesktopmacOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%/Claude/claude_desktop_config.json; Linux: ${XDG_CONFIG_HOME:-~/.config}/Claude/claude_desktop_config.jsonmcpServers
Cursor~/.cursor/mcp.jsonmcpServers
ZedmacOS: ~/Library/Application Support/Zed/settings.json; Windows: %APPDATA%/Zed/settings.json; Linux: ${XDG_CONFIG_HOME:-~/.config}/zed/settings.jsoncontext_servers
VS Code Copilot${COPILOT_HOME:-~/.copilot}/mcp-config.jsonmcpServers
json
{
  "mcpServers": {
    "tyrus": {
      "command": "/absolute/path/to/tyrus",
      "args": ["mcp", "serve"]
    }
  }
}

En Zed, usa la misma entrada tyrus bajo context_servers en su archivo de ajustes. Las ubicaciones de los archivos pueden variar según el sistema operativo, el perfil o la versión del cliente. Prefiere la interfaz de ajustes MCP del cliente cuando la ruta difiera de la predeterminada. Consulta las guías oficiales de configuración de Claude Desktop, Cursor, Zed y VS Code Copilot.

Conflictos y solución de problemas ​

Si un cliente ya tiene una entrada tyrus que el instalador no administra, el instalador la conserva e informa del conflicto. Revisa esa entrada, cámbiala o elimínala manualmente y vuelve a ejecutar tyrus mcp install. Si el archivo de configuración no es válido o no se puede conservar de forma segura, usa la interfaz de ajustes del cliente o añade la entrada manualmente.

Ejecuta tyrus mcp status para inspeccionar la caché y las entradas de los clientes. Ejecuta tyrus mcp update para actualizar la documentación desactualizada. Ejecuta tyrus mcp uninstall para eliminar las entradas que todavía coincidan con los valores registrados por Tyrus; las entradas editadas después de la instalación se conservan y deben eliminarse manualmente. Reinicia el cliente después de cambiar la configuración MCP.