Sage Veterinary Imaging

Servidor MCP público para diagnóstico por imagem veterinário — diretório com mais de 800 provedores, preços, localizações, conteúdo educacional e recursos clínicos para cães e gatos

Documentação

Sage MCP Public

Servidor Model Context Protocol para dados públicos da Sage Veterinary Imaging.

O Que Ele Oferece

TabelaRegistrosDescrição
content536Páginas do site, posts de blog, condições, artigos educacionais
providers808Diretório de provedores de imagem veterinária (40 estados)
pricing33Preços dos serviços de imagem da SVI
locations3Detalhes das unidades da SVI (Round Rock TX, Spring TX, Sandy UT)

Ferramentas MCP

  • search_content — Busca de texto completo em todo o conteúdo do site
  • get_page — Obter uma página específica pelo slug da URL
  • search_providers — Buscar mais de 800 instalações de imagem veterinária por localização/modalidade
  • get_provider — Detalhes do provedor por slug
  • get_pricing — Preços dos serviços da SVI, filtráveis por categoria
  • get_location_info — Detalhes das unidades da SVI (endereço, telefone, modalidades)
  • get_company_info — Informações da empresa, FAQs, políticas
  • get_service_info — Descrições dos serviços de imagem

Endpoints

CaminhoFinalidade
/Página pública inicial (docs + instruções de conexão, rastreável)
/mcp/httpTransporte HTTP Streamable — recomendado para clientes MCP
/mcp/sseTransporte SSE (legado, ainda suportado)
/.well-known/mcp.jsonDocumento de descoberta
/healthVerificação de saúde

Nota: mcp está fixado em <2.0.0 — o mcp 2.x removeu mcp.server.fastmcp.

Arquitetura

GitHub → Railway (FastAPI + MCP) → Supabase (PostgreSQL + PostgREST)
  • Sem PHI. Totalmente separado do servidor MCP clínico.
  • API REST Supabase para todas as consultas (sem necessidade de conexões diretas ao banco de dados).
  • Busca de texto completo via índices tsvector do PostgreSQL.

Implantação

Railway

  1. Conecte este repositório ao Railway
  2. Defina as variáveis de ambiente:
    • SUPABASE_URL — URL do projeto Supabase
    • SUPABASE_SERVICE_KEY — JWT da role de serviço
    • PORT — O Railway define isso automaticamente

Atualização de Conteúdo

Execute o worker de sincronização para re-extrair o conteúdo do site:

python -m sync.refresh

Configure como um serviço cron do Railway para atualização semanal.

Desenvolvimento Local

pip install -r requirements.txt
cp .env.example .env  # Add your Supabase credentials
python -m server.main

O servidor roda em http://localhost:8000

  • Saúde: GET /health
  • MCP: POST /mcp