OpenCRAVAT
Anotação de variante genética
Documentação
Servidor MCP OpenCRAVAT
Este repositório contém um servidor MCP (Model Context Protocol) que expõe a anotação de variantes baseada no OpenCRAVAT como ferramentas chamáveis. Ele roda como um Cloudflare Worker (via Wrangler) e faz proxy de solicitações para os serviços públicos do OpenCRAVAT.
O que este servidor fornece
Ele expõe ferramentas MCP que permitem a um cliente MCP:
- Descobrir quais anotadores do OpenCRAVAT estão sendo executados (um conjunto padrão selecionado).
- Inspecionar os esquemas de saída dos anotadores (nomes/tipos/descrições de campos).
- Anotar variantes por:
- coordenadas genômicas (crom/pos/ref/alt). Aceita apenas coordenadas GRCh38/hg38.
- dbSNP rsID
- ID do Registro de Alelos do ClinGen (CAid)
- HGVS (g./c./p.)
- Converter uma notação de missense proteica (por exemplo, BRAF V600E) em alterações HGVS genômicas candidatas do GRCh38 (via SynVar), que você pode então passar para a anotação HGVS.
Conectando
Este servidor MCP está hospedado remotamente em
https://mcp.opencravat.org/mcp
Ele também pode ser executado localmente.
Claude
Para conectar ao Claude, siga estas instruções. Use a URL acima e não configure autenticação. Nenhum dado específico do usuário é necessário para o MCP funcionar. Lembre-se de habilitar o MCP para o seu chat.
ChatGPT
Para conectar ao ChatGPT, você deve ativar o modo de desenvolvedor e depois adicionar um aplicativo personalizado:
- Abra Configurações
- Vá para Aplicativos
- Em Configurações Avançadas, use o alternador para ativar o "Modo de Desenvolvedor"
- Clique em Criar Aplicativo
- Use a URL acima como "URL do Servidor MCP"
- Defina Autenticação como "Sem Autenticação"
- Adicione um nome ao Aplicativo MCP que você reconheça facilmente, como "OpenCRAVAT"
Você terá que adicionar o MCP a um novo chat usando o ícone + no canto inferior esquerdo da caixa de chat.
Executando Localmente
Pré-requisitos:
- Node.js (recente o suficiente para ferramentas TypeScript modernas; Node 18+ recomendado)
- npm
Instale as dependências:
npm install
Inicie o servidor de desenvolvimento (Wrangler):
npm start
Por padrão, seu endpoint MCP será:
http://localhost:8787/mcp
Conectar o Claude Desktop
Para conectar seu servidor MCP ao Claude Desktop, siga o Quickstart da Anthropic e, no Claude Desktop, vá para Configurações > Desenvolvedor > Editar Configuração.
Atualize com esta configuração:
{
"mcpServers": {
"OpenCRAVAT": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:8787/mcp"
]
}
}
}
Reinicie o Claude e você verá as ferramentas ficarem disponíveis.