⚡️ mcpo

Name: ⚡️ mcpo
Author: open-webui

@open-webui

代码仓库主页

关于 ⚡️ mcpo

A simple, secure MCP-to-OpenAPI proxy server

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

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

open-webui

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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".