MCP.so
Sign In

⚡️ mcpo

@open-webui

RepositoryHomepage

About ⚡️ mcpo

A simple, secure MCP-to-OpenAPI proxy server

#mcp#openapi#open-webui#mcp-server#mcp-to-openapi

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcpo": {
      "command": "uvx",
      "args": [
        "mcpo",
        "--port",
        "8000",
        "--api-key",
        "top-secret",
        "--",
        "your_mcp_server_command"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is ⚡️ mcpo?

⚡️ mcpo is a proxy that takes any MCP server command and exposes it as an OpenAPI-compatible HTTP server instantly. It converts MCP tools into standard RESTful endpoints so they work with LLM agents and apps expecting OpenAPI servers.

How to use ⚡️ mcpo?

Use the uvx mcpo command (recommended) or pip install mcpo && mcpo to start the proxy. Specify a port, API key, and the MCP server command. For SSE or Streamable HTTP servers, use --server-type flags. Multiple tools can be served from a single JSON config file with optional hot-reload.

Key features of ⚡️ mcpo

  • Instantly exposes any MCP tool as a RESTful OpenAPI server
  • Supports stdio, SSE, and Streamable HTTP MCP transports
  • Auto‑generates interactive OpenAPI documentation for every tool
  • Adds security via API keys and OAuth 2.1 authentication
  • Allows serving multiple MCP tools from one config file
  • Hot‑reload keeps servers updated without downtime

Use cases of ⚡️ mcpo

  • Make MCP tools accessible to OpenAPI‑compatible LLM agents and tools
  • Replace insecure stdio MCP servers with secure, documented HTTP endpoints
  • Run multiple MCP servers behind a single HTTP port with unique routes
  • Integrate with Open WebUI by launching an OpenAPI proxy for MCP tools

FAQ from ⚡️ mcpo

What does mcpo do differently from native MCP?

Native MCP communicates over raw stdio, which is insecure and incompatible with most tools. mcpo wraps MCP servers as standard OpenAPI HTTP servers with interactive docs, error handling, and authentication.

What are the runtime requirements for mcpo?

Python 3.8+ is required. The uv tool is optional but highly recommended for faster startup and packaging.

How do I use mcpo with an SSE‑based MCP server?

Use the --server-type "sse" flag and provide the SSE endpoint URL. Optionally add custom headers with --header for authentication.

Does mcpo support authentication?

Yes, mcpo supports both a command‑line API key (--api-key) and OAuth 2.1 authentication for Streamable HTTP servers.

Where are OAuth tokens stored?

Tokens are stored in ~/.mcpo/tokens/ when using file‑based storage (the default). Session‑only storage is also available with "storage_type": "memory".

Frequently asked questions

What does mcpo do differently from native MCP?

Native MCP communicates over raw stdio, which is insecure and incompatible with most tools. mcpo wraps MCP servers as standard OpenAPI HTTP servers with interactive docs, error handling, and authentication.

What are the runtime requirements for mcpo?

Python 3.8+ is required. The `uv` tool is optional but highly recommended for faster startup and packaging.

How do I use mcpo with an SSE‑based MCP server?

Use the `--server-type "sse"` flag and provide the SSE endpoint URL. Optionally add custom headers with `--header` for authentication.

Does mcpo support authentication?

Yes, mcpo supports both a command‑line API key (`--api-key`) and OAuth 2.1 authentication for Streamable HTTP servers.

Where are OAuth tokens stored?

Tokens are stored in `~/.mcpo/tokens/` when using file‑based storage (the default). Session‑only storage is also available with `"storage_type": "memory"`.

Comments

Basic information

Category

Other

License

MIT

Transports

stdio

Author

open-webui

More Other MCP servers

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep