open-webui/mcpo

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

4.4천 stars 508 forks 품질 78 트렌드 33MIT

Repository Install

간단하고 안전한 MCP에서 OpenAPI 프록시 서버

개요

모든 MCP 도구를 OpenAPI 호환 HTTP 서버로 즉시 노출하세요. mcpo는 MCP 서버 명령을 받아 표준 RESTful OpenAPI를 통해 접근할 수 있게 하는 매우 단순한 프록시입니다. 그래서 도구들은 OpenAPI 서버를 기대하는 LLM 에이전트와 앱에서 "그냥 작동"합니다. 맞춤 프로토콜도 없고, 접착제 코드도 없으며, 번거로움도 없습니다. MCP 서버는 보통 원시 stdio를 통해 통신하며, 이는 다음과 같습니다: - 🔓 본질적으로 보안이 안 됨 - ❌ 대부분의 도구와 호환되지 않음 - 🧩 문서, 인증, 오류 처리 등 표준 기능이 없음. 맥포는 이 모든 문제를 추가적인 노력 없이도 해결한다: - ✅ OpenAPI 도구, SDK, UI와 즉시 호환 - 🛡 신뢰할 수 있는 웹 표준을 통해 보안, 안정성, 확장성을 추가함 - 🧠 모든 도구에 대해 자동 인터랙티브 문서를 생성, 설정 필요 없음 - 🔌 순수 HTTP 사용—소켓, 접착제 코드, 놀라움 없음 "한 걸음만 더"라고 느끼는 것은 사실 더 적은 단계에 더 좋은 결과입니다.

개요(AI 번역)

모든 MCP 도구를 OpenAPI 호환 HTTP 서버로 즉시 노출하세요.

mcpo는 MCP 서버 명령을 받아 표준 RESTful OpenAPI를 통해 접근할 수 있게 하는 매우 단순한 프록시입니다. 그래서 도구들은 OpenAPI 서버를 기대하는 LLM 에이전트와 앱에서 "그냥 작동"합니다.

맞춤 프로토콜도 없고, 접착제 코드도 없으며, 번거로움도 없습니다.

🤔 왜 원어민 MCP 대신 mcpo를 사용하나요?

MCP 서버는 보통 원시 stdio를 통해 통신하며, 이는 다음과 같습니다:

🔓 본질적으로 불안정함
❌ 대부분의 도구와 호환되지 않음
🧩 문서, 인증, 오류 처리 등 표준 기능이 누락됨.

맥포는 이 모든 문제를 추가적인 노력 없이도 해결한다:

✅ OpenAPI 도구, SDK, UI와 즉시 호환됩니다
🛡 신뢰할 수 있는 웹 표준을 사용하여 보안, 안정성, 확장성을 추가합니다
🧠 모든 도구에 대해 자동 생성되는 대화형 문서, 설정 필요 없음
🔌 순수 HTTP 사용—소켓, 접착제 코드, 놀라움 없음

"한 걸음만 더"라고 느끼는 것은 사실 더 적은 단계에 더 좋은 결과입니다.

MCPO는 여러분의 AI 도구를 지금 바로 번거롭지 않게 사용하고, 안전하며, 상호운용성을 제공합니다.

🚀 빠른 사용

번개처럼 빠른 시작과 0 설정 작업을 위해 UV를 사용하는 것을 추천합니다.

또는 파이썬을 사용 중이라면:

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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

GitHub에서 전체 README 보기

설치

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
  }
}