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étodo | Endpoint | Descrição |
|---|---|---|
| GET | /api/tools | Lista todas as ferramentas com paginação |
| POST | /api/tools | Registra uma nova ferramenta |
| GET | /api/tools/:id | Obtém ferramenta por ID |
| PATCH | /api/tools/:id | Atualiza uma ferramenta |
| DELETE | /api/tools/:id | Exclui uma ferramenta |
Busca e Descoberta
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/search?q= | Busca de texto completo |
| GET | /api/trending | Obtém ferramentas em tendência |
| GET | /api/categories | Lista todas as categorias |
| POST | /api/discovery | Envia ferramenta para revisão |
| GET | /api/health | Verificação de saúde e estatísticas |
Parâmetros de Consulta
/api/tools e /api/search
| Parâmetro | Tipo | Descrição |
|---|---|---|
q | string | Consulta de busca |
category | string | Filtrar por slug de categoria |
chain | string | Filtrar por blockchain (bsc, ethereum, etc.) |
protocol | string | Filtrar por protocolo (pancakeswap, aave, etc.) |
grade | a|b|f | Filtrar por nota de confiança |
requiresApiKey | true|false | Filtrar por exigência de chave de API |
tags | string | Tags separadas por vírgula |
page | number | Número da página (padrão: 1) |
limit | number | Itens por página (padrão: 20, máximo: 100) |
sortBy | string | Campo de ordenação: name, createdAt, totalScore, downloadCount |
sortOrder | asc|desc | Direção da ordenação (padrão: desc) |
/api/trending
| Parâmetro | Tipo | Descrição |
|---|---|---|
period | day|week|month | Período de tempo (padrão: week) |
limit | number | Número de resultados (padrão: 10, máximo: 50) |
category | string | Filtrar 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ério | Peso | Obrigatório |
|---|---|---|
| Validado | 20 | ✅ |
| Possui Ferramentas | 15 | ✅ |
| Implantação | 15 | ✅ |
| Documentação | 10 | ✅ |
| Implantação Automática | 12 | |
| Licença | 8 | |
| Prompts | 8 | |
| Recursos | 8 | |
| Reivindicado | 4 |
Notas
| Nota | Pontuação | Descrição |
|---|---|---|
| A | 80%+ | Todos os itens obrigatórios atendidos, ferramenta excelente |
| B | 60-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
- Envie para o GitHub
- Importe para o Vercel
- Adicione a variável de ambiente
DATABASE_URL - 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)
| Ferramenta | Descrição |
|---|---|
search_mcp_ecosystem | Buscar no ecossistema MCP |
get_popular_mcp_servers | Servidores MCP populares |
get_sperax_mcp_servers | Todos 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/