Saltar al contenido principal

Instalación

Requisitos​

  • Node.js >=22.12.0 (declarado en engines).

Instalación​

npm install @powerduck/openapi-mcp-server

Yarn:

yarn add @powerduck/openapi-mcp-server

pnpm:

pnpm add @powerduck/openapi-mcp-server

CLI​

El paquete registra el ejecutable openapi-mcp.

# global install
npm install -g @powerduck/openapi-mcp-server

# or run without installing
npx --package @powerduck/openapi-mcp-server openapi-mcp --help

La CLI tiene un único comando serve (consulta Inicio rápido).

ESM / CommonJS​

Se incluyen compilaciones para ambos formatos y declaraciones de tipos. No se necesitan paquetes @types/* adicionales:

// ESM
import { buildMcpServer, startStdioServer } from "@powerduck/openapi-mcp-server";

// CommonJS
const { buildMcpServer, startStdioServer } = require("@powerduck/openapi-mcp-server");

Exportación de subrutas​

ImportaciónContenido
@powerduck/openapi-mcp-serverBiblioteca principal: carga de especificaciones, generación de herramientas, prompts y recursos, ejecución de solicitudes, creación del servidor MCP y transportes stdio y HTTP.
@powerduck/openapi-mcp-server/serverServidor HTTP de administración y middleware de autenticación (startAdminServer, createAuthMiddleware).

Dependencias de ejecución​

Se instalan automáticamente con el paquete:

  • @modelcontextprotocol/sdk — implementación del protocolo MCP.
  • @powerduck/openapi-parser — validación, resolución de referencias y actualización de OpenAPI.
  • express y cors — servidor HTTP de administración y CORS.
  • axios — cliente HTTP para ejecutar las herramientas contra el servidor de destino.
  • commander — framework de la CLI.
  • js-yaml — análisis de YAML.
  • multer — gestión de la carga de especificaciones.
  • terser — minificación de los recursos de la interfaz web integrada.

Verificación​

npx --package @powerduck/openapi-mcp-server openapi-mcp --help

Siguientes pasos​