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
Maintainer
Works with
Installation
Manual Installation
npx openapi-serversConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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
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-serversChoose 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.txtStart 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 --reloadOr deploy via Docker Compose
For a production-ready or containerized setup, use Docker Compose inside the server directory.
cd servers/filesystem
docker compose upBridge 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_YorkConnect 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.
OpenAPI Servers Alternatives — Similar APIs Servers
Looking for alternatives to OpenAPI Servers? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
★ 43.4k🦍 The API and AI Gateway
API Mega List
★ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪
Fetch
★ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
★ 2.1kSelf-Hosted API Management for Builders
Korean Law
★ 1.8k국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools
RuleGo
★ 1.5k⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
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.
Set Up OpenAPI Servers in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.