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