OpenAPI Servers

v1.0.0APIsstable

OpenAPI Tool Servers

aimcpopenapi
Share:
970
Stars
0
Downloads
0
Weekly
0/5

What is OpenAPI Servers?

OpenAPI Servers is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to openapi tool servers

OpenAPI Tool Servers

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • OpenAPI Tool Servers

Use Cases

OpenAPI specification tool exposure
API-based agent capability provisioning
open-webui

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx openapi-servers

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use OpenAPI Servers

OpenAPI Servers is a collection of reference OpenAPI tool server implementations from Open WebUI that can be deployed as standalone HTTP services and connected to AI agents. It provides seven ready-to-use server types—including filesystem access, Git operations, SQL chat, memory/knowledge graphs, weather, and external RAG pipelines—each exposing their capabilities through standard OpenAPI specifications. Developers use it to rapidly provision real-world tool backends that any MCP-compatible client or OpenAPI-aware agent can consume without building custom integrations from scratch.

Prerequisites

  • Python 3.10+ and pip installed
  • Docker and Docker Compose (for containerized deployment)
  • An MCP client such as Claude Desktop or Open WebUI
  • uvicorn for local server execution (installed via pip)
  • Node.js and npx if using the mcpo MCP bridge tool
1

Clone the repository

Clone the openapi-servers repository from GitHub to get all reference server implementations.

git clone https://github.com/open-webui/openapi-servers
cd openapi-servers
2

Choose and install a server

Navigate into one of the available server directories (filesystem, git, memory, weather, sql, rag, userinfo) and install its Python dependencies.

cd servers/filesystem
pip install -r requirements.txt
3

Start the server with uvicorn

Launch the chosen OpenAPI server locally. It will expose an OpenAPI-compatible HTTP endpoint that tools and agents can call.

uvicorn main:app --host 0.0.0.0 --port 8000 --reload
4

Or deploy via Docker Compose

For a production-ready or containerized setup, use Docker Compose inside the server directory.

cd servers/filesystem
docker compose up
5

Bridge to MCP using mcpo

Use the mcpo tool to wrap any stdio MCP server as an OpenAPI HTTP server, or vice versa, enabling seamless integration between OpenAPI servers and MCP clients.

uvx mcpo --port 8000 -- uvx mcp-server-time --local-timezone=America/New_York
6

Connect your MCP client

Point your MCP client or AI agent at the running HTTP endpoint. The server's /openapi.json endpoint documents all available tools and schemas automatically.

OpenAPI Servers Examples

Client configuration for filesystem server

Example MCP client configuration using the openapi-servers filesystem server via mcpo bridge.

{
  "mcpServers": {
    "openapi-filesystem": {
      "command": "uvx",
      "args": ["mcpo", "--port", "8000", "--", "uvx", "mcp-server-filesystem", "/tmp"],
      "env": {}
    }
  }
}

Prompts to try

Example prompts for the various OpenAPI server types.

- "List all files in the /projects directory and show me the most recently modified ones"
- "Search the Git repository for commits mentioning 'authentication' in the last 30 days"
- "Query the SQL database and show me the top 10 customers by revenue"
- "What is the current weather forecast for San Francisco for the next 3 days?"
- "Search the knowledge graph for everything related to our Q3 product roadmap"

Troubleshooting OpenAPI Servers

Server starts but the MCP client cannot connect to it

Ensure the server is bound to 0.0.0.0 (not 127.0.0.1) and that the port matches your client configuration. Check firewall rules if running in a container.

pip install fails with dependency conflicts

Create a fresh virtual environment with 'python -m venv .venv && source .venv/bin/activate' before running pip install -r requirements.txt to isolate dependencies per server.

mcpo bridge returns 404 for tool endpoints

Verify the underlying stdio MCP server starts successfully on its own before wrapping with mcpo. Run the stdio command directly first to check for missing env vars or binary paths.

Frequently Asked Questions about OpenAPI Servers

What is OpenAPI Servers?

OpenAPI Servers is a Model Context Protocol (MCP) server that openapi tool servers It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OpenAPI Servers?

Follow the installation instructions on the OpenAPI Servers GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with OpenAPI Servers?

OpenAPI Servers works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is OpenAPI Servers free to use?

Yes, OpenAPI Servers is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "openapi-servers": { "command": "npx", "args": ["-y", "openapi-servers"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use OpenAPI Servers?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides