Skip to content

Tyrus MCP ​

O servidor MCP do Tyrus permite que clientes de IA compatíveis pesquisem a documentação oficial e verifiquem código Tyrus independente com a análise compartilhada do compilador. A instalação é automática para os clientes compatíveis detectados na máquina.

Instalação ​

Execute um comando após instalar o Tyrus:

bash
tyrus mcp install

O comando baixa e verifica um cache limitado da documentação, testa o handshake do servidor MCP local e adiciona uma entrada tyrus aos arquivos de configuração dos clientes detectados. Há suporte à configuração de usuário do Claude Desktop, Cursor, Zed e VS Code Copilot. As configurações existentes são preservadas, entradas tyrus existentes não são sobrescritas e arquivos alterados recebem uma cópia de segurança antes da primeira edição.

Reinicie ou recarregue cada cliente configurado. Em seguida, pergunte sobre Tyrus ao assistente. O cliente inicia tyrus mcp serve em segundo plano; normalmente você não executa esse comando manualmente. Se nenhum cliente compatível for detectado, instale um e execute tyrus mcp install novamente ou siga a configuração manual abaixo.

Comandos ​

ComandoFinalidade
tyrus mcp installBaixa o cache da documentação, configura clientes detectados e testa o handshake do servidor.
tyrus mcp updateAtualiza o cache e as entradas gerenciadas do Tyrus nos clientes.
tyrus mcp statusMostra as versões do cache, as configurações dos clientes detectados e os conflitos.
tyrus mcp uninstallRemove entradas gerenciadas inalteradas e o cache local da documentação.
tyrus mcp serveComando interno do servidor stdio iniciado por um cliente MCP configurado.

Recursos MCP disponíveis ​

RecursoDescrição
search_docsPesquisa títulos indexados e retorna trechos classificados e links oficiais.
get_pageLê uma página completa listada pelo índice da documentação.
check_sourceFaz parsing e verificação de tipos e empréstimos de até 128 KiB de código independente em memória.
tyrus://docs/indexLê o índice da documentação.
tyrus://docs/{path}Lê uma página Markdown indexada.
tyrus://llms.txtLê o índice compacto da documentação.
tyrus://llms-full.txtSolicita explicitamente o pacote completo da documentação.
generate_tyrus_codeOrienta o modelo a encontrar a documentação atual antes de gerar código.
fix_tyrus_codeOrienta o modelo a verificar e corrigir código independente.

search_docs aceita uma consulta de até 512 bytes UTF-8 e retorna no máximo 20 resultados. get_page retorna até 1 MiB por página; o recurso da documentação completa é limitado a um pacote baixado de 32 MiB. check_source aceita até 128 KiB e interrompe a análise após cinco segundos.

check_source retorna códigos de diagnóstico estáveis, severidades, mensagens, intervalos em bytes e posições de linha e coluna iniciadas em um. Não executa código, cria arquivos, lê um projeto, carrega variáveis de ambiente nem resolve imports relativos ao projeto. Imports de módulos nativos estão disponíveis quando o compilador tem declarações independentes para eles. A análise não é um sandbox de segurança. Os clientes e modelos decidem quando chamar ferramentas MCP, então o servidor não pode garantir que o assistente verificará o código ou consultará a documentação.

Configuração manual ​

Use o caminho absoluto do executável Tyrus no campo command. Preserve as demais configurações do arquivo. Cursor, Claude Desktop e Copilot usam um objeto mcpServers; Zed usa context_servers.

ClienteLocal da configuração do usuárioChave raiz
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"]
    }
  }
}

No Zed, use a mesma entrada tyrus sob context_servers no arquivo de configurações. Os locais dos arquivos podem variar conforme o sistema operacional, perfil ou versão do cliente. Prefira a interface de configurações MCP do cliente quando o caminho diferir do padrão. Consulte os guias oficiais de configuração do Claude Desktop, Cursor, Zed e VS Code Copilot.

Conflitos e solução de problemas ​

Se um cliente já tiver uma entrada tyrus que o instalador não gerencia, o instalador a preserva e informa o conflito. Revise essa entrada, altere-a ou remova-a manualmente e execute tyrus mcp install novamente. Se o arquivo de configuração for inválido ou não puder ser preservado com segurança, use a interface de configurações do cliente ou adicione a entrada manualmente.

Execute tyrus mcp status para inspecionar o cache e as entradas dos clientes. Execute tyrus mcp update para atualizar a documentação desatualizada. Execute tyrus mcp uninstall para remover entradas que ainda correspondam aos valores registrados pelo Tyrus; entradas editadas após a instalação são preservadas e devem ser removidas manualmente. Reinicie o cliente depois de alterar a configuração MCP.