Philidor MCP

Análise de risco de vaults DeFi para agentes de IA. Pesquise mais de 700 vaults em Morpho, Aave, Yearn, Beefy, Spark e outros. Compare pontuações de risco, analise protocolos, realize due diligence — tudo por meio de linguagem natural. Sem necessidade de chave de API. Sem necessidade de instalação.

Documentação

Servidor Philidor MCP

Análise de risco de vaults DeFi para agentes de IA

MIT License MCP TypeScript Hosted smithery badge LobeHub

Pesquise mais de 700 vaults DeFi em Morpho, Aave, Yearn, Beefy e Spark. Compare pontuações de risco, analise protocolos, realize due diligence — tudo por meio de linguagem natural.

Nenhuma chave de API necessária. Nenhuma instalação necessária.

Início Rápido • Ferramentas • Exemplos de Prompts • Estrutura de Risco • Habilidade do Agente


Por que Philidor?

A maioria das ferramentas de dados DeFi fornece números brutos. Philidor dá ao seu agente de IA inteligência de risco de nível institucional.

RecursoPhilidorDefiLlama MCPAPIs DeFi Genéricas
Pontuações de risco de vault (0–10):white_check_mark::x::x:
Decomposição de vetores de risco:white_check_mark::x::x:
Comparação de vaults:white_check_mark::x::x:
Inteligência de curadores:white_check_mark::x::x:
Histórico de segurança de protocolos:white_check_mark::x:Parcial
Prompts de due diligence:white_check_mark::x::x:
Avaliação de risco de portfólio:white_check_mark::x::x:
Sem necessidade de chave de API:white_check_mark::white_check_mark:Varia
Hospedado (zero instalação):white_check_mark::x::x:

Início Rápido

Servidor Remoto (Recomendado)

Conecte-se diretamente ao servidor hospedado — zero instalação, sempre atualizado:

https://mcp.philidor.io/api/mcp

Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "philidor": {
      "url": "https://mcp.philidor.io/api/mcp"
    }
  }
}

Claude Code

claude mcp add philidor --transport http https://mcp.philidor.io/api/mcp

Cursor

Adicione ao .cursor/mcp.json:

{
  "mcpServers": {
    "philidor": {
      "url": "https://mcp.philidor.io/api/mcp"
    }
  }
}

Windsurf

Adicione às suas configurações de MCP:

{
  "mcpServers": {
    "philidor": {
      "serverUrl": "https://mcp.philidor.io/api/mcp"
    }
  }
}

Docker (stdio)

docker run -i --rm ghcr.io/philidor-labs/philidor-mcp

Local (stdio)

git clone https://github.com/Philidor-Labs/philidor-mcp.git
cd philidor-mcp
npm install
npm start

Ferramentas

10 ferramentas para descoberta de vaults, análise de risco e pesquisa de protocolos.

search_vaults

Pesquise e filtre vaults DeFi por rede, protocolo, ativo, nível de risco, TVL e mais.

ParâmetroTipoDescrição
querystringPesquise por nome do vault, símbolo, ativo, protocolo ou curador
chainstringFiltre por rede (Ethereum, Base, Arbitrum, ...)
protocolstringFiltre por ID do protocolo (morpho, aave-v3, yearn-v3, beefy, spark)
assetstringFiltre por símbolo do ativo (USDC, WETH, ...)
riskTierstringFiltre por nível de risco: Prime, Core ou Edge
minTvlnumberTVL mínimo em USD
sortBystringCampo de ordenação: tvl_usd, apr_net, name
sortOrderstringOrdem de classificação: asc ou desc
limitnumberMáximo de resultados (padrão 10, máximo 50)

get_vault

Obtenha informações detalhadas sobre um vault específico, incluindo detalhamento de risco, eventos recentes e snapshots históricos. Consulta por id ou por network + address.

ParâmetroTipoDescrição
idstringID do vault (ex.: morpho-ethereum-0x...)
networkstringSlug da rede (ethereum, base, arbitrum)
addressstringEndereço do contrato do vault (0x...)

get_vault_risk_breakdown

Detalhamento dos três vetores de risco de um vault com sub-métricas: qualidade do ativo, maturidade do código da plataforma e controles de governança. Retorna pontuações por dimensão, limites, flags de falha crítica e overrides.

ParâmetroTipoDescrição
networkstringSlug da rede
addressstringEndereço do contrato do vault

compare_vaults

Comparação lado a lado de 2–3 vaults em TVL, APR, pontuação de risco, nível de risco e status de auditoria.

ParâmetroTipoDescrição
vaultsarrayArray de 2–3 objetos com network e address

find_safest_vaults

Encontre os 10 principais vaults auditados e de alta confiança, ordenados por pontuação de risco.

ParâmetroTipoDescrição
assetstringFiltre por símbolo do ativo
chainstringFiltre por nome da rede
minTvlnumberTVL mínimo em USD

get_protocol_info

Detalhes do protocolo, incluindo TVL, número de vaults, versões, auditores, recompensas por bugs e incidentes de segurança.

ParâmetroTipoDescrição
protocolIdstringID do protocolo (morpho, aave-v3, yearn-v3, beefy, spark)

get_curator_info

Detalhes do curador, incluindo vaults gerenciados, TVL, distribuição por rede e métricas de desempenho.

ParâmetroTipoDescrição
curatorIdstringID do curador

get_market_overview

Estatísticas de alto nível do mercado de vaults DeFi: TVL total, número de vaults, distribuição de risco e TVL por protocolo. Nenhum parâmetro necessário.

explain_risk_score

Explique o que uma pontuação de risco específica significa, incluindo o nível, o método de cálculo e os limites.

ParâmetroTipoDescrição
scorenumberPontuação de risco (0–10)

list_vaults_with_incidents

Liste todos os vaults que tiveram um incidente crítico recente (últimos 365 dias). Ordenado por TVL decrescente e depois por recência. Nenhum parâmetro necessário.


Recursos

URIDescrição
philidor://methodologyDocumentação do Vector Risk Framework v4.1
philidor://supported-chainsRedes blockchain suportadas com contagens de vaults
philidor://supported-protocolsProtocolos DeFi suportados com dados de TVL

Prompts

PromptDescrição
vault_due_diligenceRelatório abrangente de due diligence para um vault
portfolio_risk_assessmentAnálise de risco em nível de portfólio entre posições
defi_yield_comparisonComparação de rendimento com análise ajustada ao risco

Exemplos de Prompts

Depois de conectado, tente perguntar ao seu assistente de IA:

Descoberta

"Encontre os vaults USDC mais seguros com pelo menos US$ 10 milhões em TVL"

"Quais vaults Morpho estão disponíveis na Base?"

"Mostre-me a visão geral do mercado DeFi"

Análise

"Faça due diligence no vault Steakhouse USDC na Ethereum"

"Compare os 3 principais vaults USDC por pontuação de risco"

"Qual é o detalhamento de risco deste vault: ethereum/0x..."

Portfólio

"Avalie meu portfólio: 50% em Morpho Steakhouse USDC, 30% em Aave USDC, 20% em Yearn USDC"

"Quais protocolos tiveram incidentes de segurança?"

"O que significa uma pontuação de risco de 8,5?"


Pontuação de Risco

Philidor usa o Vector Risk Framework v4.1 para decompor o risco de vaults em três vetores mensuráveis:

Final Score = 40% Asset + 40% Platform + 20% Governance

Composição do Ativo (40%)

Qualidade da garantia subjacente. Ativos blue-chip (ETH, USDC) pontuam mais alto. Os fatores incluem confiabilidade do oráculo, profundidade de liquidez e estabilidade da paridade.

Código da Plataforma (40%)

Maturidade do código medida por:

  • Pontuação Lindy — segurança baseada no tempo (>2 anos ≈ 9/10)
  • Densidade de Auditoria — número e qualidade das auditorias
  • Risco de Dependências — penalidades multiplicativas para dependências arriscadas
  • Penalidade por Incidentes — limita a pontuação após incidentes de segurança

Governança (20%)

Janela de saída para usuários:

ControlePontuação
Contrato imutável10/10
Timelock de 7+ dias9/10
Sem timelock1/10

Níveis de Risco

NívelPontuaçãoSignificado
Prime8,0–10,0Nível institucional — código maduro, múltiplas auditorias, governança segura
Core5,0–7,9Segurança moderada — auditado, mas mais novo ou com governança flexível
Edge0,0–4,9Risco mais alto — requer due diligence cuidadosa

Arquitetura

┌──────────────────┐     ┌─────────────────┐     ┌──────────────┐
│  Claude / Cursor  │────▶│  Philidor MCP   │────▶│ Philidor API │
│  Windsurf / etc.  │◀────│  Server         │◀────│              │
└──────────────────┘     └─────────────────┘     └──────┬───────┘
                          10 tools, 3 resources,         │
                          3 prompts                      │
                                                   ┌────▼────┐
                                                   │ On-chain │
                                                   │  data    │
                                                   └─────────┘
  • Transporte: HTTP transmissível (remoto) ou stdio (local/Docker)
  • API: Chama a API Pública Philidor — sem necessidade de chave de API
  • Sem estado: Instância de servidor nova por solicitação, sem estado de sessão
  • Dados: Mais de 700 vaults em Ethereum, Base, Arbitrum, Polygon, Optimism e Avalanche

Habilidade do Agente

Instale a habilidade Philidor MCP no seu agente de codificação via skills.sh:

npx skills add philidor-labs/philidor-mcp

Isso dá ao seu agente conhecimento completo de todas as ferramentas, recursos, prompts, fluxos de trabalho recomendados e melhores práticas para análise de vaults DeFi.

Também Disponível

InterfaceDescriçãoLink
CLIInteligência de vaults baseada em terminal — scriptável, canalizável, sandbox para agentesphilidor-cli
Habilidade OpenClawDefinição de habilidade para a plataforma de agentes OpenClawnpm

Protocolos Suportados

Morpho, Aave v3, Yearn v3, Beefy, Spark — com mais sendo adicionados regularmente.

Veja a lista completa em app.philidor.io.


Desenvolvimento

git clone https://github.com/Philidor-Labs/philidor-mcp.git
cd philidor-mcp
npm install
npm start

O servidor se conecta à API pública Philidor por padrão. Para usar um endpoint personalizado:

PHILIDOR_API_URL=http://localhost:3003 npm start

Links

Licença

MIT