OpenAPI Mcp Server
Description
# OpenAPI MCP Server This application exposes any REST API as an MCP (Model Context Protocol) server based on its OpenAPI schema. It automatically generates MCP tools from OpenAPI operations with comprehensive OpenAPI 3.0+ support. ## Features - **Complete OpenAPI 3.0+…
About
# OpenAPI MCP Server This application exposes any REST API as an MCP (Model Context Protocol) server based on its OpenAPI schema. It automatically generates MCP tools from OpenAPI operations with comprehensive OpenAPI 3.0+ support. ## Features - **Complete OpenAPI 3.0+ Support**: Parse schemas from JSON and YAML…
Details
- Author
- FusionWorks
- Downloads
- 284
- Categories
- Other, API
Jump to
- Complete OpenAPI 3.0+ support with JSON and YAML parsing
- Advanced schema processing: $ref resolution and composition (oneOf/anyOf/allOf)
- Automatic MCP tool generation with rich descriptions and validation
- Multiple content types: JSON, XML, form data, multipart uploads
- Authentication via HTTP Basic Auth or custom headers
- TypeScript implementation with 90%+ test coverage
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
OpenAPI Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install and build the project with npm install && npm build. Run it using npm start -- --schema <path-to-schema> [options]. You can also add the server to Claude Desktop by editing its configuration file and providing the full path to the built index.js and your schema file.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"openapi mcp server": {
"openapi-server": {
"command": "node",
"args": [
"/path/to/your/openapi-mcp-server/dist/index.js",
"--schema",
"/path/to/your/openapi-schema.yaml"
]
}
}
}
}McpServers
{
"openapi-server": {
"command": "node",
"args": [
"/path/to/your/openapi-mcp-server/dist/index.js",
"--schema",
"/path/to/your/openapi-schema.yaml"
]
}
}OpenAPI MCP Server
This application exposes any REST API as an MCP (Model Context Protocol) server based on its OpenAPI schema. It automatically generates MCP tools from OpenAPI operations with comprehensive OpenAPI 3.0+ support.Features
- Complete OpenAPI 3.0+ Support: Parse schemas from JSON and YAML formats - Advanced Schema Processing: Full $ref resolution, composition schemas (oneOf, anyOf, allOf) - Rich Tool Generation: Automatic MCP tools with detailed descriptions, validation, and metadata - Multiple Content Types: Support for JSON, XML, form data, and multipart uploads - Parameter Handling: Path, query, header parameters with type conversion and validation - Authentication: HTTP Basic Authentication and custom headers support - Enhanced Error Handling: Detailed error messages with request context - Type Safety: Full TypeScript implementation with comprehensive validation - Testing: Extensive test suite with 90%+ coverageInstallation
``bash
npm install
npm run build
`
Usage
`bash
npm start -- --schema <path-to-openapi-schema> [options]
`
Options
- -s, --schema <path> - Path to OpenAPI schema file (JSON or YAML) [Required]
- -b, --base-url <url> - Override base URL from schema
- -h, --headers <headers> - Additional headers as JSON string
- -u, --username <username> - Username for basic authentication
- -p, --password <password> - Password for basic authentication
Examples
``bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
