Ana içeriğe geç

Kurulum

Gereksinimler​

  • Node.js >=22.12.0 (engines içinde belirtilir).

Kurulum​

npm install @powerduck/openapi-mcp-server

Yarn:

yarn add @powerduck/openapi-mcp-server

pnpm:

pnpm add @powerduck/openapi-mcp-server

CLI​

Paket openapi-mcp programını kaydeder.

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

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

CLI’ın tek komutu serve’dür (bkz. Hızlı başlangıç).

ESM / CommonJS​

Her iki derleme biçimi de tür bildirimlerini içerir. Ek @types/* gerekmez:

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

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

Alt yol dışa aktarımı​

İçe aktarmaİçerik
@powerduck/openapi-mcp-serverÇekirdek kitaplık: belirtim yükleme, araç/prompt/kaynak üretimi, istek yürütme, MCP sunucusu oluşturma, stdio ve HTTP aktarımları.
@powerduck/openapi-mcp-server/serverYönetim HTTP sunucusu ve kimlik doğrulama ara katmanı (startAdminServer, createAuthMiddleware).

Çalışma zamanı bağımlılıkları​

Bu bağımlılıklar paketle birlikte otomatik kurulur:

  • @modelcontextprotocol/sdk — MCP protokolü uygulaması.
  • @powerduck/openapi-parser — OpenAPI doğrulaması, başvuru çözümleme ve sürüm yükseltme.
  • express ve cors — yönetim HTTP sunucusu ve CORS.
  • axios — araç yürütme sırasında hedef hizmete bağlanan HTTP istemcisi.
  • commander — CLI çatısı.
  • js-yaml — YAML ayrıştırma.
  • multer — belirtim yüklemelerinin işlenmesi.
  • terser — gömülü web arayüzü varlıklarının küçültülmesi.

Doğrulama​

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

Sonraki adımlar​