open-webui/mcpo

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

4,4 тыс. stars 508 forks Качество 78 Тренд 33MIT

Repository Install

Простой и защищённый прокси-сервер MCP-to-OpenAPI

Обзор

Мгновенно открывайте любой MCP-инструмент как HTTP-сервер, совместимый с OpenAPI. MCPO — это очень простой прокси, который принимает команду MCP-сервера и делает её доступной через стандартный RESTful OpenAPI, так что ваши инструменты «просто работают» с LLM-агентами и приложениями, ожидающими OpenAPI-серверов. Нет пользовательского протокола. Нет кода клея. Никаких хлопот. MCP-серверы обычно говорят по raw stdio, а именно: - 🔓 По своей природе небезопасный — ❌ несовместим с большинством инструментов — 🧩 отсутствуют стандартные функции, такие как документация, аутентификация, обработка ошибок и т.д. MCPO решает всё это — без лишних усилий: - ✅ Мгновенно работает с инструментами OpenAPI, SDK и интерфейсами - 🛡 Добавляет безопасность, стабильность и масштабируемость с помощью проверенных веб-стандартов - 🧠 Автоматически генерирует интерактивную документацию для каждого инструмента, без необходимости конфигурации - 🔌 Использует чистый HTTP — без сокетов, без кода, без сюрпризов То, что кажется «ещё одним шагом», на самом деле меньше шагов с лучшими результатами.

Обзор (машинный перевод)

Мгновенно открывайте любой MCP-инструмент как HTTP-сервер, совместимый с OpenAPI.

MCPO — это очень простой прокси, который принимает команду MCP-сервера и делает её доступной через стандартный RESTful OpenAPI, так что ваши инструменты «просто работают» с LLM-агентами и приложениями, ожидающими OpenAPI-серверов.

Нет пользовательского протокола. Нет кода клея. Никаких хлопот.

🤔 Почему использовать mcpo вместо нативного MCP?

MCP-серверы обычно говорят по raw stdio, а именно:

🔓 Врождённая неуверенность
❌ Несовместимый с большинством инструментов
🧩 Отсутствие стандартных функций, таких как документация, аутентификация, обработка ошибок и т.д.

MCPO решает всё это — без лишних усилий:

✅ Мгновенно работает с инструментами OpenAPI, SDK и интерфейсами
🛡 Добавляет безопасность, стабильность и масштабируемость с использованием проверенных веб-стандартов
🧠 Автоматически генерирует интерактивную документацию для каждого инструмента, конфигурация не требуется.
🔌 Использует чистый HTTP — без сокетов, без клеевого кода, без сюрпризов

То, что кажется «ещё одним шагом», на самом деле меньше шагов с лучшими результатами.

MCpo делает ваши инструменты ИИ удобными, безопасными и совместимыми — прямо сейчас, без лишних хлопот.

🚀 Быстрое использование

Рекомендуем использовать UV для молниеносного запуска и нулевой конфигурации.

Или, если вы используете Python:

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

⚡️ mcpo

Expose any MCP tool as an OpenAPI-compatible HTTP server—instantly.

mcpo is a dead-simple proxy that takes an MCP server command and makes it accessible via standard RESTful OpenAPI, so your tools “just work” with LLM agents and apps expecting OpenAPI servers.

No custom protocol. No glue code. No hassle.

🤔 Why Use mcpo Instead of Native MCP?

MCP servers usually speak over raw stdio, which is:

🔓 Inherently insecure
❌ Incompatible with most tools
🧩 Missing standard features like docs, auth, error handling, etc.

mcpo solves all of that—without extra effort:

✅ Works instantly with OpenAPI tools, SDKs, and UIs
🛡 Adds security, stability, and scalability using trusted web standards
🧠 Auto-generates interactive docs for every tool, no config needed
🔌 Uses pure HTTP—no sockets, no glue code, no surprises

What feels like “one more step” is really fewer steps with better outcomes.

mcpo makes your AI tools usable, secure, and interoperable—right now, with zero hassle.

🚀 Quick Usage

We recommend using uv for lightning-fast startup and zero config.

uvx mcpo --port 8000 --api-key "top-secret" -- your_mcp_server_command

Or, if you’re using Python:

pip install mcpo
mcpo --port 8000 --api-key "top-secret" -- your_mcp_server_command

To use an SSE-compatible MCP server, simply specify the server type and endpoint:

mcpo --port 8000 --api-key "top-secret" --server-type "sse" -- http://127.0.0.1:8001/sse

You can also provide headers for the SSE connection:

mcpo --port 8000 --api-key "top-secret" --server-type "sse" --header '{"Authorization": "Bearer token", "X-Custom-Header": "value"}' -- http://127.0.0.1:8001/sse

To use a Streamable HTTP-compatible MCP server, specify the server type and endpoint:

mcpo --port 8000 --api-key "top-secret" --server-type "streamable-http" -- http://127.0.0.1:8002/mcp

You can also run mcpo via Docker with no installation:

docker run -p 8000:8000 ghcr.io/open-webui/mcpo:main --api-key "top-secret" -- your_mcp_server_command

Example:

uvx mcpo --port 8000 --api-key "top-secret" -- uvx mcp-server-time --local-timezone=America/New_York

That’s it. Your MCP tool is now available at http://localhost:8000 with a generated OpenAPI schema — test it live at http://localhost:8000/docs.

🤝 To integrate with Open WebUI after launching the server, check our docs.

🌐 Serving Under a Subpath (`--root-path`)

If you need to serve mcpo behind a reverse proxy or under a subpath (e.g., /api/mcpo), use the --root-path argument:

mcpo --port 8000 --root-path "/api/mcpo" --api-key "top-secret" -- your_mcp_server_command

All routes will be served under the specified root path, e.g. http://localhost:8000/api/mcpo/memory.

🔄 Using a Config File

Открыть полный README на GitHub

Установка

npx -y @modelcontextprotocol/server-memory

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time", "--local-timezone=America/New_York"],
      "disabledTools": ["convert_time"] // Disable specific tools if needed
    },
    "mcp_sse": {
      "type": "sse", // Explicitly define type
      "url": "http://127.0.0.1:8001/sse",
      "headers": {
        "Authorization": "Bearer token",
        "X-Custom-Header": "value"
      }
    },
    "mcp_streamable_http": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:8002/mcp"
    } // Streamable HTTP MCP Server
  }
}