Lerian MCP Server

Proporciona contenido educativo, información de modelos e interacciones de API de solo lectura para desarrolladores de Lerian.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de Lerian

Una puerta de enlace MCP para el descubrimiento del portafolio de Lerian, documentación, aprendizaje, ejemplos de SDK, acceso a la API de productos en vivo y flujos de trabajo entre productos.

Este servidor conecta clientes MCP como Claude Desktop, Cursor, Windsurf, Continue y ChatGPT Desktop con el portafolio de productos de Lerian. Brinda a los asistentes de IA una forma estructurada de descubrir los productos de Lerian, leer documentación oficial, generar ejemplos de implementación, inspeccionar contratos de API en vivo, ejecutar APIs de productos configuradas y guiar flujos de trabajo operativos entre productos.

Alcance del tiempo de ejecución: este servidor no es solo de documentación. La herramienta unificada lerian está orientada a lectura, pero las herramientas *-execute específicas de producto pueden llamar a APIs de Lerian en vivo configuradas. Las llamadas a APIs que mutan datos requieren confirmación explícita y un motivo de auditoría.

Configuración en 2 minutos

Elige tu asistente de IA compatible con MCP.
Agrega la configuración del servidor.
Reinicia la aplicación de IA.
Pregunta: "¿Qué puedes contarme sobre Lerian Midaz?"

Claude Desktop

Ubicación en macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Ubicación en Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "lerian": {
      "command": "npx",
      "args": ["-y", "@lerianstudio/lerian-mcp-server@latest"]
    }
  }
}

Cursor, Windsurf, Continue, ChatGPT Desktop

Agrega el mismo bloque de servidor MCP a la configuración MCP de tu cliente:

{
  "mcpServers": {
    "lerian": {
      "command": "npx",
      "args": ["-y", "@lerianstudio/lerian-mcp-server@latest"]
    }
  }
}

Lo que obtienes

Productos compatibles

Midaz: libro mayor de doble entrada unificado: organizaciones, libros mayores, cuentas, saldos, transacciones y CRM detrás de un único servicio.
Fetcher: conexión de fuentes de datos, descubrimiento de esquemas y servicio de extracción asíncrona.
Reporter: generación de informes basada en plantillas, gestión de fuentes de datos, métricas y artefactos.
Matcher: motor de conciliación para comparar transacciones de Midaz con sistemas externos.
Tracer: motor de validación de transacciones con reglas, límites, validaciones y auditabilidad.
Flowker: plataforma de orquestación de flujos de trabajo para proveedores, ejecutores, webhooks y flujos de ejecución.
Underwriter: superficie de préstamos consciente de la jurisdicción para productos de préstamo y vista previa de calendarios.
All: descubrimiento en todo el portafolio, búsqueda de documentación y comparación.

Capacidades principales

Descubrimiento del portafolio mediante lerian con operation="discover".
Consulta de documentación mediante lerian con operation="docs".
Aprendizaje guiado mediante lerian con operation="learn".
Ejemplos de SDK mediante lerian con operation="sdk".
Búsqueda entre productos mediante lerian con operation="search".
Descubrimiento de contratos de API en vivo mediante herramientas *-discover específicas de producto.
Ejecución de API en vivo mediante herramientas *-execute específicas de producto.
Flujos de trabajo entre productos mediante portfolio-workflow.
Orientación basada en prompts para incorporación, aprendizaje, uso de API y flujos de trabajo operativos.

Superficie de herramientas en tiempo de ejecución

El servidor expone un núcleo pequeño más pares de API en vivo para cada producto compatible.

Herramientas principales

lerian: herramienta de portafolio unificada para documentación, aprendizaje, ejemplos de SDK, descubrimiento y búsqueda.
portfolio-workflow: descubrimiento de flujos de trabajo entre productos, planificación, sesiones con estado y ejecución de pasos.

Herramientas de API en vivo

midaz-discover y midaz-execute
fetcher-discover y fetcher-execute
reporter-discover y reporter-execute
matcher-discover y matcher-execute
tracer-discover y tracer-execute
flowker-discover y flowker-execute
underwriter-discover y underwriter-execute

Usa la herramienta *-discover correspondiente antes de llamar a una herramienta *-execute. El descubrimiento devuelve recursos, acciones, parámetros de ruta, parámetros de consulta, esquemas de cuerpo, ejemplos y sugerencias de ejecución.

La herramienta `lerian`

La herramienta lerian es el punto de entrada principal orientado a lectura.

Tool: lerian

Parameters:
  product          midaz | fetcher | reporter | matcher | tracer | flowker | underwriter | all
  operation        discover | docs | learn | sdk | search
  topic            Topic to inspect, learn, or search
  language         go | typescript | javascript, for SDK examples
  useCase          Specific implementation scenario for SDK examples
  experienceLevel  beginner | intermediate | advanced
  format           summary | detailed | examples-only
  includeExamples  true | false
  maxResults       1-50, for search

Ejemplo:

{
  "product": "midaz",
  "operation": "learn",
  "topic": "transactions",
  "experienceLevel": "beginner"
}

Flujo de trabajo de API en vivo

El acceso a la API en vivo es intencionalmente de dos pasos.

Inspecciona la superficie del producto:

{
  "intent": "list-resources"
}

Inspecciona el contrato de una acción específica:

{
  "intent": "describe-action",
  "resource": "transactions",
  "action": "create"
}

Ejecuta con el contrato exacto devuelto por el descubrimiento:

{
  "resource": "transactions",
  "action": "create",
  "pathParams": {
    "organizationId": "...",
    "ledgerId": "..."
  },
  "body": {
    "description": "Example transaction"
  },
  "confirmMutation": true,
  "mutationReason": "Create example transaction requested by operator"
}

Las acciones de API en vivo que mutan datos requieren:

confirmMutation: true
mutationReason con un motivo de auditoría legible por humanos

Flujos de trabajo entre productos

Usa portfolio-workflow cuando la tarea abarque múltiples productos de Lerian.

Flujos de trabajo actuales:

fetcher-to-reporter: valida los mapeos de extracción con Fetcher y luego genera o inspecciona informes de Reporter.
matcher-to-fetcher-to-midaz: configura la conciliación de Matcher, usa el descubrimiento de Matcher sobre Fetcher e inspecciona los datos del lado del libro mayor de Midaz.

Intenciones compatibles:

list-workflows
describe-workflow
plan
create-session
get-session
list-sessions
execute-step
execute-next

Las sesiones de flujo de trabajo devuelven un sessionToken opaco. Mantenlo privado.

Configuración

El servidor funciona de inmediato para documentación y descubrimiento. La ejecución de API en vivo requiere servicios de producto accesibles y, cuando corresponda, tokens o claves de API.

Fuentes de configuración, en orden de prioridad:

--config o --config-file de línea de comandos
Variables de entorno
./lerian-mcp-config.json
./midaz-mcp-config.json
~/.lerian/mcp-config.json
~/.midaz/mcp-config.json
~/.config/lerian/mcp-config.json
~/.config/midaz/mcp-config.json
Rutas de configuración global de la plataforma

Crea o actualiza la configuración de forma interactiva:

npx -y -p @lerianstudio/lerian-mcp-server@latest lerian-mcp-config

Midaz es un servicio de libro mayor unificado al que se accede mediante una única URL base. Incorporación, cuentas, saldos, transacciones y CRM son todos recursos de ese único servicio, por lo que hay exactamente una URL de Midaz para configurar.

Variables de entorno comunes:

LERIAN_DOCS_URL=https://docs.lerian.studio
LOG_LEVEL=info

MIDAZ_BASE_URL=http://localhost:3002
MIDAZ_AUTH_TOKEN=...
MIDAZ_API_TIMEOUT=30000

FETCHER_MANAGER_URL=http://localhost:4006
FETCHER_AUTH_TOKEN=...

REPORTER_MANAGER_URL=http://localhost:4005
REPORTER_AUTH_TOKEN=...

MATCHER_BASE_URL=http://localhost:4018
MATCHER_AUTH_TOKEN=...

TRACER_BASE_URL=http://localhost:4020
TRACER_API_KEY=...

FLOWKER_BASE_URL=http://localhost:4021
FLOWKER_AUTH_TOKEN=...
FLOWKER_API_KEY=...

UNDERWRITER_BASE_URL=http://localhost:8080
UNDERWRITER_AUTH_TOKEN=...

Migración a 4.0.0

Cambio importante: configuración de Midaz. Las versiones anteriores a 4.0.0 esperaban cuatro URL separadas de Midaz, una por servicio heredado (incorporación, transacción, CRM, libro mayor). Esas variables ya no existen: no se leen ni se aceptan. Apunta MIDAZ_BASE_URL a tu libro mayor de Midaz unificado y mantén MIDAZ_AUTH_TOKEN como está. Nada más en la configuración cambió.

Modelo de seguridad

La ejecución en vivo es opcional mediante herramientas *-execute específicas de producto.
Los métodos que mutan datos requieren confirmación explícita y un motivo de mutación.
Las URL base de las API de producto deben usar http o https.
Las URL HTTP que no sean de localhost se rechazan; se requiere HTTPS fuera del desarrollo local.
Las URL con credenciales incrustadas se rechazan.
Los encabezados de autorización y claves de API están protegidos contra anulaciones arbitrarias.
Los tamaños de carga y descarga binaria están limitados por límites configurables.
Los secretos se generan y gestionan localmente bajo ~/.lerian/secrets.json cuando es necesario.

Conversaciones de ejemplo

Descubrimiento del portafolio

Tú: "¿Con qué productos de Lerian puede ayudar este MCP?"

IA: Usa lerian con product="all", operation="discover".

Ruta de aprendizaje

Tú: "Soy nuevo en Tracer. Enséñame cómo funcionan las reglas de validación."

IA: Usa lerian con product="tracer", operation="learn", topic="rules".

Ejemplo de SDK

Tú: "Muéstrame código Go para crear un libro mayor de Midaz."

IA: Usa lerian con product="midaz", operation="sdk", language="go".

Descubrimiento de contrato de API en vivo

Tú: "Inspecciona el contrato para crear una plantilla de Reporter."

IA: Usa reporter-discover antes de cualquier llamada a reporter-execute.

Flujo de trabajo entre productos

Tú: "Guíame para validar los mapeos de Fetcher antes de generar un informe."

IA: Usa portfolio-workflow con workflow="fetcher-to-reporter".

Desarrollo

Requiere Node.js >=20.19.0.

npm ci
npm run build
npm test

Scripts útiles:

npm run dev: ejecuta el punto de entrada de TypeScript con ts-node.
npm run build: compila a dist/ y marca los binarios como ejecutables.
npm run lint: ejecuta ESLint.
npm run typecheck: ejecuta TypeScript sin emitir archivos.
npm test: ejecuta las pruebas de Node más la prueba básica del servidor.
npm run docs: genera la salida de TypeDoc en docs/.

Documentación

Información del paquete

Paquete npm: @lerianstudio/lerian-mcp-server — la página de npm y los lanzamientos de GitHub contienen la versión actual y el registro de cambios.
Tiempo de ejecución: Node.js ESM
Transporte: solo stdio
Licencia: Apache-2.0
Repositorio: github.com/lerianstudio/lerian-mcp-server

Resumen de arquitectura

MCP Client
  -> stdio transport
  -> MCP server runtime
  -> core tools and prompts
  -> product adapters
  -> product routers and schema registries
  -> configured Lerian product APIs

Capas principales:

Transporte: MCP JSON-RPC sobre stdio.
Arranque del servidor: seguridad, secretos, manifiesto de documentación, registro, detección de clientes.
Herramientas principales: lerian y portfolio-workflow.
Adaptadores de producto: pares de descubrimiento/ejecución para productos compatibles.
Registros de esquemas: contratos de recursos/acciones para superficies de API.
Ejecución HTTP: construcción de URL validada, ejecución de solicitudes, análisis de respuestas y clasificación de errores.
Orquestación de flujos de trabajo: flujos guiados entre múltiples productos con estado.

Solución de problemas

El servidor no se inicia

Verifica la versión de Node.js:

node --version

Ejecuta manualmente:

npx -y @lerianstudio/lerian-mcp-server@latest

Verifica los secretos locales:

ls -la ~/.lerian/secrets.json

Las llamadas a la API en vivo fallan

Usa primero la herramienta *-discover del producto.
Verifica que la URL base y el token/clave de API correspondientes estén configurados.
Confirma que las URL remotas que no sean locales usen HTTPS.
Para mutaciones, incluye confirmMutation=true y mutationReason.
Verifica si el servicio del producto de destino es accesible desde el tiempo de ejecución de MCP.

La herramienta no responde en el cliente

Reinicia el cliente MCP después de los cambios de configuración.
Confirma que MCP esté habilitado en el cliente.
Habilita el registro con LOG_LEVEL=debug si es necesario.
Revisa ./logs/ cuando el registro esté habilitado.

Lerian MCP Server

Documentación

Servidor MCP de Lerian

Configuración en 2 minutos

Claude Desktop

Cursor, Windsurf, Continue, ChatGPT Desktop

Lo que obtienes

Productos compatibles

Capacidades principales

Superficie de herramientas en tiempo de ejecución

Herramientas principales

Herramientas de API en vivo

La herramienta lerian

Flujo de trabajo de API en vivo

Flujos de trabajo entre productos

Configuración

Migración a 4.0.0

Modelo de seguridad

Conversaciones de ejemplo

Descubrimiento del portafolio

Ruta de aprendizaje

Ejemplo de SDK

Descubrimiento de contrato de API en vivo

Flujo de trabajo entre productos

Desarrollo

Documentación

Información del paquete

Resumen de arquitectura

Solución de problemas

El servidor no se inicia

Las llamadas a la API en vivo fallan

La herramienta no responde en el cliente

La herramienta `lerian`