Specbridge

Specbridge

Easily turn your OpenAPI specs into MCP Tools.

5
Stars
6
Forks
0
Releases

Overview

SpecBridge is an MCP server that turns OpenAPI specifications into MCP tools. It scans a folder for OpenAPI spec files and automatically generates corresponding tools. There are no configuration files or separate servers required—drop your specs into a folder and SpecBridge will expose them as MCP tools. Built with FastMCP for TypeScript, it supports multiple transports (stdio and HTTP streaming) and can be run via the CLI or integrated into MCP client configurations. Authentication is auto-detected from environment variables using patterns like {API_NAME}_API_KEY, {API_NAME}_TOKEN, or {API_NAME}_BEARER_TOKEN, enabling API key or Bearer token schemes. Tools are named automatically based on the operationId when present, or derived from the API name, HTTP method, and path segments, and namespace isolation ensures multiple APIs can coexist without conflicts (e.g., petstore_getPet, github_getUser). The server provides full OpenAPI feature support, including parameters, request bodies, authentication, and responses, and includes a built-in debugging command to list loaded specs and tools. The README also covers quick start steps, authentication patterns, and troubleshooting guidance for a smooth setup.

Details

Owner
TBosak
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Zero Configuration

Filesystem is the interface—drop OpenAPI specs into a folder to automatically generate MCP tools.

Auto Authentication

Auto-detects credentials via a .env file using {API_NAME}_API_KEY patterns for API key or Bearer token schemes.

Namespace Isolation

Allows multiple APIs to coexist cleanly (e.g., petstore_getPet, github_getUser).

Full OpenAPI Support

Handles parameters, request bodies, authentication, and responses.

Multiple Transports

Supports stdio and HTTP streaming transports.

Built-in Debugging

Includes a list command to view loaded specs and tools.

Built with FastMCP

Implemented using the FastMCP framework for TypeScript.

Automatic Tool Naming

Names tools from operationId when present, or derives from API name, method, and path segments.

Audience

DevelopersTurn OpenAPI specs into MCP tools that can be consumed in MCP client workflows.
MCP clientsEasily load and use generated tools via MCP clients like Claude Desktop or Cursor.

Tags

OpenAPIMCPTools generationZero ConfigurationAuthenticationTransportsFilesystemDebuggingSpecBridgeOpenAPI specsNamespace isolation