mcpo  by open-webui

OpenAPI proxy for MCP tools

Created 5 months ago
3,319 stars

Top 14.5% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

mcpo is a proxy server that exposes any Model Context Protocol (MCP) tool as an OpenAPI-compatible HTTP server. It targets developers and users who need to integrate MCP-based tools with LLM agents and applications that expect standard RESTful APIs, providing a secure, stable, and interoperable interface without custom glue code.

How It Works

mcpo acts as a bridge between the MCP's stdio communication and standard HTTP. It takes an MCP server command or an SSE endpoint, wraps it, and exposes it via a RESTful API. This approach leverages familiar web standards for security, documentation (auto-generated OpenAPI schemas), and ease of integration, eliminating the inherent insecurity and incompatibility of raw stdio communication.

Quick Start & Requirements

  • Install via pip install mcpo or use uvx mcpo for a zero-config experience.
  • Run with: mcpo --port 8000 --api-key "top-secret" -- your_mcp_server_command
  • Docker image available: ghcr.io/open-webui/mcpo:main
  • Requirements: Python 3.8+, uv (optional, recommended).
  • Interactive docs available at http://localhost:8000/docs.

Highlighted Details

  • Instantly exposes MCP tools via OpenAPI-compatible HTTP servers.
  • Auto-generates interactive OpenAPI documentation for each exposed tool.
  • Supports both command-line MCP servers and SSE-compatible endpoints.
  • Can serve multiple MCP tools from a single configuration file.

Maintenance & Community

  • Project is part of the open-webui organization.
  • Community contributions are encouraged via pull requests.

Licensing & Compatibility

  • License: MIT.
  • Permissive license suitable for commercial use and integration with closed-source applications.

Limitations & Caveats

The project appears to be actively maintained, with no explicit limitations or caveats mentioned in the README regarding alpha status or known bugs.

Health Check
Last Commit

1 month ago

Responsiveness

1 day

Pull Requests (30d)
4
Issues (30d)
11
Star History
191 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.