MCP Registry - Lyra

O Registro Lyra é um serviço de API independente que cataloga, pontua e fornece metadados para todas as ferramentas do ecossistema Lyra. Ele permite descoberta, avaliação e integração de mais de 800 ferramentas de cripto, blockchain, DeFi, memecoin, NFT, metaverso, trading e ferramentas MCP.

Documentação

🌙 Lyra Registry

O NPM para Ferramentas de IA Cripto - Registro central para o ecossistema Lyra

Lyra Registry é um serviço de API independente que cataloga, pontua e serve metadados para todas as ferramentas do ecossistema Lyra. Ele permite descoberta, avaliação e integração de mais de 800 ferramentas MCP de cripto e DeFi.

Entre builds, estou trabalhando na limpeza do repositório principal da Lyra com mais de 800 ferramentas de blockchain e criptomoedas. Espero lançá-lo em breve.

✨ Recursos

  • 📊 Pontuação de Confiança - Cada ferramenta é pontuada usando o algoritmo SperaxOS
  • 🔍 Busca e Filtros - Busca de texto completo com filtros por categoria, rede e protocolo
  • 📈 Tendências - Acompanhe popularidade e uso das ferramentas
  • 🔌 Integração MCP - Pré-carregamento automático a partir de servidores Lyra MCP em execução
  • 🚀 Implante em Qualquer Lugar - Implante em qualquer host Node em minutos

A demonstração pública está offline enquanto a hospedagem está sendo migrada. Execute localmente com o Início Rápido abaixo, ou leia o código-fonte em github.com/nirholas/lyra-registry.

🏗️ Stack Tecnológico

  • Framework: Next.js 14 (App Router)
  • Banco de Dados: PostgreSQL (Neon/Supabase)
  • ORM: Drizzle
  • Linguagem: TypeScript
  • Validação: Zod

🚀 Início Rápido

1. Clone e Instale

git clone https://github.com/nirholas/lyra-registry.git
cd lyra-registry
npm install

2. Configure o Banco de Dados

Crie um banco de dados PostgreSQL no Neon ou Supabase (o plano gratuito funciona).

cp .env.example .env
# Edit .env with your DATABASE_URL

3. Execute as Migrações

npm run db:push

4. Popule o Banco de Dados

Se você tiver um servidor Lyra MCP em execução:

LYRA_MCP_URL=http://localhost:3001/mcp npm run db:seed

Ou popule com dados de exemplo:

npm run db:seed

5. Inicie o Servidor de Desenvolvimento

npm run dev

Visite http://localhost:3000 para ver a página inicial.

📡 Referência da API

Ferramentas

MétodoEndpointDescrição
GET/api/toolsLista todas as ferramentas com paginação
POST/api/toolsRegistra uma nova ferramenta
GET/api/tools/:idObtém ferramenta por ID
PATCH/api/tools/:idAtualiza uma ferramenta
DELETE/api/tools/:idExclui uma ferramenta

Busca e Descoberta

MétodoEndpointDescrição
GET/api/search?q=Busca de texto completo
GET/api/trendingObtém ferramentas em tendência
GET/api/categoriesLista todas as categorias
POST/api/discoveryEnvia ferramenta para revisão
GET/api/healthVerificação de saúde e estatísticas

Parâmetros de Consulta

/api/tools e /api/search

ParâmetroTipoDescrição
qstringConsulta de busca
categorystringFiltrar por slug de categoria
chainstringFiltrar por blockchain (bsc, ethereum, etc.)
protocolstringFiltrar por protocolo (pancakeswap, aave, etc.)
gradea|b|fFiltrar por nota de confiança
requiresApiKeytrue|falseFiltrar por exigência de chave de API
tagsstringTags separadas por vírgula
pagenumberNúmero da página (padrão: 1)
limitnumberItens por página (padrão: 20, máximo: 100)
sortBystringCampo de ordenação: name, createdAt, totalScore, downloadCount
sortOrderasc|descDireção da ordenação (padrão: desc)

/api/trending

ParâmetroTipoDescrição
periodday|week|monthPeríodo de tempo (padrão: week)
limitnumberNúmero de resultados (padrão: 10, máximo: 50)
categorystringFiltrar por categoria

Exemplos de Requisições

# Search for DeFi tools
curl "http://localhost:3000/api/search?q=defi&category=defi"

# Get top 10 trending tools this week
curl "http://localhost:3000/api/trending?period=week&limit=10"

# Get all security tools
curl "http://localhost:3000/api/tools?category=security&sortBy=totalScore"

# Register a new tool
curl -X POST "http://localhost:3000/api/tools" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my_custom_tool",
    "description": "A custom DeFi tool",
    "category": "defi",
    "inputSchema": {
      "type": "object",
      "properties": {
        "address": { "type": "string" }
      },
      "required": ["address"]
    },
    "chains": ["ethereum", "bsc"],
    "tags": ["defi", "portfolio"]
  }'

⭐ Algoritmo de Pontuação de Confiança

Cada ferramenta é pontuada usando o algoritmo de confiança SperaxOS. A pontuação determina a nota da ferramenta:

CritérioPesoObrigatório
Validado20✅
Possui Ferramentas15✅
Implantação15✅
Documentação10✅
Implantação Automática12
Licença8
Prompts8
Recursos8
Reivindicado4

Notas

NotaPontuaçãoDescrição
A80%+Todos os itens obrigatórios atendidos, ferramenta excelente
B60-79%Todos os itens obrigatórios atendidos, boa ferramenta
F<60%Itens obrigatórios ausentes ou pontuação baixa

📁 Estrutura do Projeto

lyra-registry/
├── src/
│   ├── app/
│   │   ├── api/
│   │   │   ├── tools/
│   │   │   │   ├── route.ts        # GET/POST /api/tools
│   │   │   │   └── [id]/
│   │   │   │       └── route.ts    # GET/PATCH/DELETE /api/tools/:id
│   │   │   ├── search/
│   │   │   │   └── route.ts        # GET /api/search
│   │   │   ├── trending/
│   │   │   │   └── route.ts        # GET /api/trending
│   │   │   ├── categories/
│   │   │   │   └── route.ts        # GET/POST /api/categories
│   │   │   ├── discovery/
│   │   │   │   └── route.ts        # GET/POST /api/discovery
│   │   │   └── health/
│   │   │       └── route.ts        # GET /api/health
│   │   ├── globals.css
│   │   ├── layout.tsx
│   │   └── page.tsx                # Landing page
│   ├── db/
│   │   ├── index.ts                # Database connection
│   │   ├── schema.ts               # Drizzle schema
│   │   └── seed.ts                 # Seed script
│   ├── lib/
│   │   ├── calculateScore.ts       # Trust score algorithm (from SperaxOS)
│   │   └── validation.ts           # Zod schemas
│   └── types/
│       └── index.ts                # TypeScript types
├── drizzle.config.ts
├── next.config.ts
├── package.json
├── tsconfig.json
└── README.md

🚢 Implantação

Vercel

  1. Envie para o GitHub
  2. Importe para o Vercel
  3. Adicione a variável de ambiente DATABASE_URL
  4. Implante

Railway

railway init
railway add
railway variables set DATABASE_URL=...
railway up

🤝 Integração com o Ecossistema Lyra

Pré-carregamento Automático do Servidor Lyra MCP

O registro pode importar automaticamente ferramentas de um servidor Lyra MCP em execução:

# Start Lyra server
cd ../Lyra && bun run build && bun dist/cli.mjs --transport=http --port=3001

# Seed registry
cd ../lyra-registry
LYRA_MCP_URL=http://localhost:3001/mcp npm run db:seed

Pipeline de Descoberta (via Lyra-Intel)

O projeto lyra-intel pode descobrir e enviar automaticamente novas ferramentas:

# In lyra-intel
from lyra_intel.discovery import RegistrySubmitter

submitter = RegistrySubmitter("http://localhost:3000/api/discovery")
await submitter.submit_tool(tool, security_result)

📜 Licença

Todos os direitos reservados. Veja LICENSE.

🔗 Links

  • Lyra MCP Server - O servidor MCP principal com mais de 280 ferramentas
  • Lyra Intel - Descoberta automática e varredura de segurança
  • SperaxOS - A fonte do algoritmo de pontuação
  • Sperax - Ecossistema Sperax

🌐 Implantação HTTP ao Vivo

Lyra Registry está implantado e acessível via HTTP através do transporte MCP Streamable HTTP — sem necessidade de instalação local.

Endpoint:

https://modelcontextprotocol.name/mcp/lyra-registry

Conecte-se de Qualquer Cliente MCP

Adicione à configuração do seu cliente MCP (Claude Desktop, Cursor, SperaxOS, etc.):

{
  "mcpServers": {
    "lyra-registry": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/lyra-registry"
    }
  }
}

Ferramentas Disponíveis (3)

FerramentaDescrição
search_mcp_ecosystemBuscar no ecossistema MCP
get_popular_mcp_serversServidores MCP populares
get_sperax_mcp_serversTodos os servidores MCP Sperax

Exemplos de Requisições

Buscar no ecossistema MCP:

curl -X POST https://modelcontextprotocol.name/mcp/lyra-registry \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_mcp_ecosystem","arguments":{"query":"crypto defi"}}}'

Servidores MCP populares:

curl -X POST https://modelcontextprotocol.name/mcp/lyra-registry \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_popular_mcp_servers","arguments":{"category":"crypto"}}}'

Todos os servidores MCP Sperax:

curl -X POST https://modelcontextprotocol.name/mcp/lyra-registry \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_sperax_mcp_servers","arguments":{}}}'

Listar Todas as Ferramentas

curl -X POST https://modelcontextprotocol.name/mcp/lyra-registry \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Também Disponível Em

  • SperaxOS - fonte para o marketplace MCP. O marketplace hospedado está offline enquanto a hospedagem está sendo migrada.
  • Todos os 27 servidores MCP — Veja o catálogo completo em modelcontextprotocol.name

Desenvolvido por modelcontextprotocol.name — o gateway HTTP MCP aberto

Documentação

Site completo de documentação: https://nirholas.github.io/lyra-registry/

  • Começando cobre instalação e primeira execução.
  • Exemplos tem trechos prontos para copiar e colar.