api-mcp-server

api-mcp-server

0

API Suggestion Server is an MCP server that recommends appropriate API endpoints based on OpenAPI specifications, tailored to user needs. It integrates with AI models through the MCP protocol, offering dynamic endpoint suggestions.

API Suggestion Server

Overview

API Suggestion Server is an MCP (Model Context Protocol) server that suggests appropriate API endpoints based on OpenAPI specifications. It recommends the best available API endpoint tailored to the user's goals and requirements.

Features

  • Collects API endpoint information from multiple OpenAPI specifications in YAML or JSON format.
  • Suggests relevant API endpoints based on user objectives.
  • Integrates with AI models via the MCP protocol.

Prerequisites

  • Node.js 18 or higher
  • npm or yarn

Usage

Start the server

Run the server using npm. The server communicates using the MCP protocol via standard I/O.

Customization

Adding New OpenAPI Specifications

  1. Place OpenAPI files in the schemas directory, or provide a public URL.
  2. Edit server.config.ts to add a new service.

Supported Formats

  • OpenAPI in YAML format (.yaml or .yml)
  • OpenAPI in JSON format (.json)
  • OpenAPI specified via URL (automatically parsed based on content type)

Development

Build

Run the build process using npm.

Test

Tests are available for different categories such as OpenAPI document parsing and server initialization.