@buildwithlayer/openapi-to-tools NPM

OpenAPI to Tools

This is a simple package to convert OpenAPI routes to tools to be used by MCP servers or other LLM applications.

Prerequisites

This project requires NodeJS (version 18 or later) and NPM. Node and NPM are really easy to install. To make sure you have them available on your machine, try running the following command.

$ npm -v && node -v
10.2.4
v20.11.0

OpenAPI to Tools

Installation

BEFORE YOU INSTALL: please read the prerequisites

To install and set up the library, run:

$ npm install @buildwithlayer/openapi-to-tools

Or if you prefer using Yarn:

$ yarn add @buildwithlayer/openapi-to-tools

Usage

CLI

input_file_path is a path to any valid OpenAPI Spec 3.X.X
output_file_path is a path to a JSON file to write the tools

npx @buildwithlayer/openapi-to-tools <input_file_path> [-o <output_file_path>]

MCP Server

import {addAPIToolsPlugin} from '@buildwithlayer/openapi-to-tools/index.js';
import {apiTools} from './tools.json';

const server = new McpServer(
    {
        name: 'very-cool-server',
        version: '1.0.0',
    },
    {
        capabilities: {
            tools: {},
        },
    },
);

// Add any manual tools
server.tool('hello-world', async () => ({
    content: [
        {
            text: 'Hello, world!',
            type: 'text',
        },
    ],
}));

// Add the API tools (generated with CLI or using the library)
addAPIToolsPlugin(server, apiTools);

// Start receiving messages on stdin and sending messages on stdout
const transport = new StdioServerTransport();
await server.connect(transport);