[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72183":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":30,"readmeContent":31,"aiSummary":32,"trendingCount":16,"starSnapshotCount":16,"syncStatus":33,"lastSyncTime":34,"discoverSource":35},72183,"mcpo","open-webui\u002Fmcpo","open-webui","A simple, secure MCP-to-OpenAPI proxy server","https:\u002F\u002Fdocs.openwebui.com\u002Ffeatures\u002Fplugin\u002Ftools\u002Fopenapi-servers\u002Fmcp",null,"Python",4248,464,25,36,0,10,18,63,30,"MIT License",false,"main",true,[26,27,28,7,29],"mcp","mcp-server","mcp-to-openapi","openapi","2026-06-12 02:02:59","# ⚡️ mcpo\n\nExpose any MCP tool as an OpenAPI-compatible HTTP server—instantly.\n\nmcpo 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.\n\nNo custom protocol. No glue code. No hassle.\n\n## 🤔 Why Use mcpo Instead of Native MCP?\n\nMCP servers usually speak over raw stdio, which is:\n\n- 🔓 Inherently insecure\n- ❌ Incompatible with most tools\n- 🧩 Missing standard features like docs, auth, error handling, etc.\n\nmcpo solves all of that—without extra effort:\n\n- ✅ Works instantly with OpenAPI tools, SDKs, and UIs\n- 🛡 Adds security, stability, and scalability using trusted web standards\n- 🧠 Auto-generates interactive docs for every tool, no config needed\n- 🔌 Uses pure HTTP—no sockets, no glue code, no surprises\n\nWhat feels like \"one more step\" is really fewer steps with better outcomes.\n\nmcpo makes your AI tools usable, secure, and interoperable—right now, with zero hassle.\n\n## 🚀 Quick Usage\n\nWe recommend using uv for lightning-fast startup and zero config.\n\n```bash\nuvx mcpo --port 8000 --api-key \"top-secret\" -- your_mcp_server_command\n```\n\nOr, if you’re using Python:\n\n```bash\npip install mcpo\nmcpo --port 8000 --api-key \"top-secret\" -- your_mcp_server_command\n```\n\nTo use an SSE-compatible MCP server, simply specify the server type and endpoint:\n\n```bash\nmcpo --port 8000 --api-key \"top-secret\" --server-type \"sse\" -- http:\u002F\u002F127.0.0.1:8001\u002Fsse\n```\n\nYou can also provide headers for the SSE connection:\n\n```bash\nmcpo --port 8000 --api-key \"top-secret\" --server-type \"sse\" --header '{\"Authorization\": \"Bearer token\", \"X-Custom-Header\": \"value\"}' -- http:\u002F\u002F127.0.0.1:8001\u002Fsse\n```\n\nTo use a Streamable HTTP-compatible MCP server, specify the server type and endpoint:\n\n```bash\nmcpo --port 8000 --api-key \"top-secret\" --server-type \"streamable-http\" -- http:\u002F\u002F127.0.0.1:8002\u002Fmcp\n```\n\nYou can also run mcpo via Docker with no installation:\n\n```bash\ndocker run -p 8000:8000 ghcr.io\u002Fopen-webui\u002Fmcpo:main --api-key \"top-secret\" -- your_mcp_server_command\n```\n\nExample:\n\n```bash\nuvx mcpo --port 8000 --api-key \"top-secret\" -- uvx mcp-server-time --local-timezone=America\u002FNew_York\n```\n\nThat’s it. Your MCP tool is now available at http:\u002F\u002Flocalhost:8000 with a generated OpenAPI schema — test it live at [http:\u002F\u002Flocalhost:8000\u002Fdocs](http:\u002F\u002Flocalhost:8000\u002Fdocs).\n\n🤝 **To integrate with Open WebUI after launching the server, check our [docs](https:\u002F\u002Fdocs.openwebui.com\u002Fopenapi-servers\u002Fopen-webui\u002F).**\n\n\n### 🌐 Serving Under a Subpath (`--root-path`)\n\nIf you need to serve mcpo behind a reverse proxy or under a subpath (e.g., `\u002Fapi\u002Fmcpo`), use the `--root-path` argument:\n\n```bash\nmcpo --port 8000 --root-path \"\u002Fapi\u002Fmcpo\" --api-key \"top-secret\" -- your_mcp_server_command\n```\n\nAll routes will be served under the specified root path, e.g. `http:\u002F\u002Flocalhost:8000\u002Fapi\u002Fmcpo\u002Fmemory`.\n\n\n### 🔄 Using a Config File\n\nYou can serve multiple MCP tools via a single config file that follows the [Claude Desktop](https:\u002F\u002Fmodelcontextprotocol.io\u002Fquickstart\u002Fuser) format.\n\nEnable hot-reload mode with `--hot-reload` to automatically watch your config file for changes and reload servers without downtime:\n\nStart via:\n\n```bash\nmcpo --config \u002Fpath\u002Fto\u002Fconfig.json\n```\n\nOr with hot-reload enabled:\n\n```bash\nmcpo --config \u002Fpath\u002Fto\u002Fconfig.json --hot-reload\n```\n\nExample config.json:\n\n```json\n{\n  \"mcpServers\": {\n    \"memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol\u002Fserver-memory\"]\n    },\n    \"time\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-server-time\", \"--local-timezone=America\u002FNew_York\"],\n      \"disabledTools\": [\"convert_time\"] \u002F\u002F Disable specific tools if needed\n    },\n    \"mcp_sse\": {\n      \"type\": \"sse\", \u002F\u002F Explicitly define type\n      \"url\": \"http:\u002F\u002F127.0.0.1:8001\u002Fsse\",\n      \"headers\": {\n        \"Authorization\": \"Bearer token\",\n        \"X-Custom-Header\": \"value\"\n      }\n    },\n    \"mcp_streamable_http\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"http:\u002F\u002F127.0.0.1:8002\u002Fmcp\"\n    } \u002F\u002F Streamable HTTP MCP Server\n  }\n}\n```\n\nEach tool will be accessible under its own unique route, e.g.:\n- http:\u002F\u002Flocalhost:8000\u002Fmemory\n- http:\u002F\u002Flocalhost:8000\u002Ftime\n\nEach with a dedicated OpenAPI schema and proxy handler. Access full schema UI at: `http:\u002F\u002Flocalhost:8000\u002F\u003Ctool>\u002Fdocs`  (e.g. \u002Fmemory\u002Fdocs, \u002Ftime\u002Fdocs)\n\n### 🔐 OAuth 2.1 Authentication\n\nmcpo supports OAuth 2.1 authentication for MCP servers that require it. The implementation defaults to **dynamic client registration**, so most servers only need minimal configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"oauth-protected-server\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"http:\u002F\u002Flocalhost:8000\u002Fmcp\",\n      \"oauth\": {\n        \"server_url\": \"http:\u002F\u002Flocalhost:8000\"\n      }\n    }\n  }\n}\n```\n\n#### OAuth Configuration Options\n\n**Basic Options:**\n- `server_url` (required): OAuth server base URL\n- `storage_type`: \"file\" (persistent) or \"memory\" (session-only, default: \"file\")\n- `callback_port`: Local port for OAuth callback (default: 3030)\n- `use_loopback`: Auto-open browser for auth (default: true)\n\n**Advanced Options (rarely needed):**\nFor servers that don't support dynamic client registration, you can specify static client metadata:\n\n```json\n{\n  \"mcpServers\": {\n    \"legacy-oauth-server\": {\n      \"type\": \"streamable-http\", \n      \"url\": \"http:\u002F\u002Fapi.example.com\u002Fmcp\",\n      \"oauth\": {\n        \"server_url\": \"http:\u002F\u002Fapi.example.com\",\n        \"client_metadata\": {\n          \"client_name\": \"My MCPO Client\",\n          \"redirect_uris\": [\"http:\u002F\u002Flocalhost:3030\u002Fcallback\"]\n        }\n      }\n    }\n  }\n}\n```\n\n> **Note**: Avoid setting `scope`, `authorization_endpoint`, or `token_endpoint` in the config. These are automatically discovered from the server's OAuth metadata during the dynamic registration flow.\n\nOn first connection, mcpo will:\n1. Perform dynamic client registration (if supported)\n2. Open your browser for authorization\n3. Capture the OAuth callback automatically  \n4. Store tokens securely (in `~\u002F.mcpo\u002Ftokens\u002F` for file storage)\n5. Use tokens for all subsequent requests\n\nOAuth is supported for `streamable-http` server types. See [OAUTH_GUIDE.md](OAUTH_GUIDE.md) for detailed documentation.\n\n## 🔧 Requirements\n\n- Python 3.8+\n- uv (optional, but highly recommended for performance + packaging)\n\n## 🛠️ Development & Testing\n\nTo contribute or run tests locally:\n\n1.  **Set up the environment:**\n    ```bash\n    # Clone the repository\n    git clone https:\u002F\u002Fgithub.com\u002Fopen-webui\u002Fmcpo.git\n    cd mcpo\n\n    # Install dependencies (including dev dependencies)\n    uv sync --dev\n    ```\n\n2.  **Run tests:**\n    ```bash\n    uv run pytest\n    ```\n\n3.  **Running Locally with Active Changes:**\n\n    To run `mcpo` with your local modifications from a specific branch (e.g., `my-feature-branch`):\n\n    ```bash\n    # Ensure you are on your development branch\n    git checkout my-feature-branch\n\n    # Make your code changes in the src\u002Fmcpo directory or elsewhere\n\n    # Run mcpo using uv, which will use your local, modified code\n    # This command starts mcpo on port 8000 and proxies your_mcp_server_command\n    uv run mcpo --port 8000 -- your_mcp_server_command\n\n    # Example with a test MCP server (like mcp-server-time):\n    # uv run mcpo --port 8000 -- uvx mcp-server-time --local-timezone=America\u002FNew_York\n    ```\n    This allows you to test your changes interactively before committing or creating a pull request. Access your locally running `mcpo` instance at `http:\u002F\u002Flocalhost:8000` and the auto-generated docs at `http:\u002F\u002Flocalhost:8000\u002Fdocs`.\n\n\n## 🪪 License\n\nMIT\n\n## 🤝 Contributing\n\nWe welcome and strongly encourage contributions from the community!\n\nWhether you're fixing a bug, adding features, improving documentation, or just sharing ideas—your input is incredibly valuable and helps make mcpo better for everyone.\n\nGetting started is easy:\n\n- Fork the repo\n- Create a new branch\n- Make your changes\n- Open a pull request\n\nNot sure where to start? Feel free to open an issue or ask a question—we’re happy to help you find a good first task.\n\n## ✨ Star History\n\n\u003Ca href=\"https:\u002F\u002Fstar-history.com\u002F#open-webui\u002Fmcpo&Date\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=open-webui\u002Fmcpo&type=Date&theme=dark\" \u002F>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=open-webui\u002Fmcpo&type=Date\" \u002F>\n    \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=open-webui\u002Fmcpo&type=Date\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n---\n\n✨ Let's build the future of interoperable AI tooling together!\n","mcpo 是一个将 MCP 服务器命令转换为 OpenAPI 兼容的 HTTP 服务器的简单代理工具。其核心功能是通过标准 RESTful OpenAPI 接口暴露 MCP 工具，无需自定义协议或粘合代码，即可与期望 OpenAPI 服务的 LLM 代理和应用无缝集成。mcpo 支持自动生成交互式文档、增强安全性及稳定性，并提供多种部署方式，包括 Python 脚本、Docker 容器等。适用于需要将现有的 MCP 服务快速安全地转化为 Web 标准 API 的场景，特别适合那些希望简化 AI 工具集成流程并提升其可用性和互操作性的开发者。",2,"2026-06-11 03:40:43","high_star"]