mcpo
A simple, secure MCP-to-OpenAPI proxy server
mcpo is an MCP-to-OpenAPI proxy server that exposes any Model Context Protocol server as a standard RESTful HTTP API. It transforms MCP servers that normally communicate over stdio, SSE, or streamable HTTP into OpenAPI-compatible endpoints with auto-generated documentation, security features, and OAuth 2.1 support. Developers use mcpo to make MCP tools instantly compatible with platforms expecting OpenAPI servers, eliminating the need for custom integration code. The server supports both single MCP tool proxying and multi-server configurations with hot-reload capabilities.
Key Features
Use Cases
- 01Exposing MCP servers as REST APIs for integration with Open WebUI and other OpenAPI-compatible platforms
- 02Converting stdio-based MCP tools into secure HTTP services with authentication
- 03Creating centralized API gateways that proxy multiple MCP servers through a single endpoint
- 04Adding OAuth-protected MCP server access to applications without custom protocol handling
- 05Deploying MCP tools behind reverse proxies with custom subpath routing
- 06Testing and debugging MCP servers through browser-based Swagger/OpenAPI UI
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
mcpo — FAQ
What is mcpo and what does it do?+
mcpo is a proxy server that converts Model Context Protocol (MCP) servers into standard OpenAPI-compatible HTTP REST APIs. It allows MCP tools that normally speak over stdio, SSE, or custom protocols to be accessed as regular web services with auto-generated documentation and security features.
How do I install and run mcpo?+
Install mcpo using pip (pip install mcpo) or run it directly with uvx without installation (uvx mcpo). Launch it by specifying a port, optional API key, and the MCP server command you want to proxy, such as: uvx mcpo --port 8000 --api-key "secret" -- uvx mcp-server-time.
Which AI clients and platforms work with mcpo?+
mcpo works with any platform that supports OpenAPI/REST APIs, including Open WebUI (with specific integration documentation available). It acts as a bridge that makes MCP servers compatible with tools expecting standard HTTP APIs rather than MCP protocol.
Do I need API keys or special configuration?+
mcpo itself requires Python 3.8+ to run. You can optionally set an --api-key for securing your proxy endpoints. If proxying OAuth-protected MCP servers, mcpo supports OAuth 2.1 with automatic dynamic client registration and will guide you through browser-based authorization on first connection.
Is mcpo free and open source?+
Yes, mcpo is released under the MIT license and is completely free to use. The source code is available on GitHub at open-webui/mcpo, and contributions from the community are welcomed.
Can I proxy multiple MCP servers at once?+
Yes, mcpo supports multi-server configurations through a JSON config file using the Claude Desktop format. Each MCP server gets its own route (e.g., /memory, /time) with dedicated OpenAPI docs, and you can enable --hot-reload to update configurations without restarting.
How do I install mcpo?+
Open the source repository on GitHub and follow its README. mcpo is a mcp server — MCP Agents Market links you directly to the official repo.
Is mcpo free?+
mcpo is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.