Servidor MCP AgentLayer

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona datos de infraestructura de IA en tiempo real mediante TypeScript + Hono en Cloudflare Workers.

Descripción general

El servidor MCP AgentLayer expone 5 endpoints para el consumo de agentes de IA:

Características

• Autenticación: Autenticación mediante clave API en todos los endpoints

• Limitación de tasa: Límites configurables por clave API

• Registro de uso: Registro completo de solicitudes/respuestas

• Gestión de errores: Gestión integral de errores con respuestas significativas

• Micropagos x402: Soporte nativo para el protocolo de pago x402

• Facturación con Stripe: Niveles de suscripción (Starter $99/mes, Pro $299/mes, Scale $499/mes)

• Análisis de sentimiento: Scraping automatizado de Reddit/HN para puntuaciones de sentimiento de modelos

Stack tecnológico

• Runtime: Cloudflare Workers

• Framework: Hono (ligero, rápido)

• Lenguaje: TypeScript

• Base de datos: Neon Postgres (serverless)

• Pagos: Stripe + protocolo x402

• Ingesta de datos: Firecrawl API

Inicio rápido

Requisitos previos

• Node.js 20+

• Cuenta de Cloudflare

• Base de datos Neon

• Cuenta de Stripe

• Clave API de Firecrawl

Instalación

npm install

Configuración del entorno

Copia .env.example a .env y configura:

cp .env.example .env

Variables requeridas:

• NEON_DATABASE_URL - Cadena de conexión de Neon Postgres

• FIRECRAWL_API_KEY - Clave API de Firecrawl

• STRIPE_SECRET_KEY - Clave secreta de Stripe

• STRIPE_STARTER_PRICE_ID - ID de precio de Stripe para el nivel Starter

• STRIPE_PRO_MONTHLY_PRICE_ID - ID de precio de Stripe para el nivel Pro

• STRIPE_SCALE_MONTHLY_PRICE_ID - ID de precio de Stripe para el nivel Scale

Configuración de la base de datos

# Apply schema to Neon
npx tsx scripts/setup-neon-db.ts

# Verify tables created
npx tsx scripts/verify-db.ts

Desarrollo

npm run dev

Despliegue

npm run deploy

Documentación de la API

Autenticación

Todos los endpoints requieren una clave API a través de cabecera o parámetro de consulta:

X-API-Key: your-api-key
# or
?api_key=your-api-key

Endpoints

GET /llm-costs

Devuelve datos de precios de LLM.

curl -H "X-API-Key: your-key" https://your-worker.workers.dev/llm-costs

GET /model-benchmarks

Devuelve resultados de benchmarks de modelos.

curl -H "X-API-Key: your-key" https://your-worker.workers.dev/model-benchmarks

GET /api-deprecations

Devuelve versiones de API obsoletas.

curl -H "X-API-Key: your-key" https://your-worker.workers.dev/api-deprecations

GET/POST /quality-scores

Puntuaciones de calidad con actualización opcional de sentimiento.

# Get scores
curl -H "X-API-Key: your-key" https://your-worker.workers.dev/v1/quality-scores

# Trigger sentiment refresh
curl -H "X-API-Key: your-key" "https://your-worker.workers.dev/v1/quality-scores?refresh=true"

POST /agent-spend

Registra el gasto de API del agente con soporte para micropagos x402.

curl -X POST -H "X-API-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"agent-123","model":"gpt-4","tokens_used":1500,"cost":0.045,"payment_receipt":"x402-receipt"}' \
  https://your-worker.workers.dev/agent-spend

GET /agent-spend

Recupera registros de gasto del agente.

curl -H "X-API-Key: your-key" "https://your-worker.workers.dev/agent-spend?agent_id=agent-123"

Envío a MCP Hub

Este servidor implementa el Protocolo de Contexto de Modelo para la integración de agentes de IA. Envíalo a MCP Hub con:

• Nombre del servidor: agentlayer-mcp-server

• Descripción: Datos de infraestructura de IA en tiempo real (costes, benchmarks, depreciaciones, puntuaciones de calidad, seguimiento de gastos)

• Transporte: HTTP con autenticación mediante clave API

• Repositorio: https://github.com/[org]/agentlayer-mcp-server

Arquitectura

src/
├── index.ts                    # Main Hono app with all endpoints
├── routes/
│   └── v1-quality-scores.ts   # Quality scores route with sentiment refresh
└── scrapers/
    └── reddit-hn-sentiment.ts # Reddit/HN sentiment scraper via Firecrawl

CI/CD

Flujo de trabajo de GitHub Actions (.github/workflows/deploy.yml):

• Se ejecuta al hacer push a main

• Comprobación de tipos con TypeScript

• Despliegue en Cloudflare Workers

Secretos de GitHub requeridos:

• CLOUDFLARE_API_TOKEN

• CLOUDFLARE_ACCOUNT_ID

• NEON_DATABASE_URL

• FIRECRAWL_API_KEY

• STRIPE_SECRET_KEY

• STRIPE_STARTER_PRICE_ID

• STRIPE_PRO_MONTHLY_PRICE_ID

• STRIPE_SCALE_MONTHLY_PRICE_ID

Licencia

MIT

Soporte

Para problemas y solicitudes de funciones, utiliza el rastreador de problemas de GitHub.