mcpo  by open-webui

OpenAPI proxy for MCP tools

created 4 months ago
2,953 stars

Top 16.6% 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 day ago

Responsiveness

1 day

Pull Requests (30d)
15
Issues (30d)
16
Star History
1,369 stars in the last 90 days

Explore Similar Projects

Starred by Didier Lopes Didier Lopes(Founder of OpenBB), Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), and
2 more.

fastmcp by jlowin

2.1%
15k
Pythonic SDK for building Model Context Protocol (MCP) servers/clients
created 8 months ago
updated 22 hours ago
Feedback? Help us improve.