supercorp-ai/supergateway

Developer tools

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

2.9천 stars 262 forks 품질 87 트렌드 48MIT

Repository Install

MCP STDIO 서버는 SSE 위에, SSE 서버는 STDIO 위에서 운영하세요. AI 게이트웨이.

개요

하나의 명령어를 위에서 또는 한 명령어로 실행합니다. 이는 MCP 서버가 stdio만 지원할 때 원격 접속, 디버깅, 클라이언트 연결에 유용합니다. - : stdio에서 MCP 서버를 실행하는 명령어 - : SSE URL 접속 (SSE→stdio 모드) - : StreamableHttp→stdio 모드로 연결할 수 있는 스트리밍 가능한 HTTP URL - : 출력 MCP 전송 (기본값: --stdio가 있는 sse, --sse 또는 --streamableHttp가 있는 stdio) - : 듣기 위한 포트(stdio→SSE 또는 stdio→WS 모드, 기본값: 8000) - : SSE 또는 WS 클라이언트용 기본 URL (stdio→SSE 모드; 선택 사항) - : SSE 구독 경로 (stdio→SSE 모드, 기본값: /sse) - : 메시지 경로 (stdio→SSE 또는 stdio→WS 모드, 기본값: /message) - : 스트리밍 가능한 HTTP 경로 (stdio→Streamable HTTP 모드, 기본값: /mcp) - : 상태 기반 모드에서 stdio→Streamable HTTP 실행 - : 세션 타임아웃 단위 밀리초 단위 (상태 기반 stdio→스트리밍 가능한 HTTP 모드 전용) - : 하나 이상의 헤더 추가(stdio→SSE, SSE→stdio, 또는 Streamable HTTP→stdio 모드; 여러 번 사용 가능) - : Authorization 헤더를 추가함...

개요(AI 번역)

Supergateway는 SSE(서버-전송 이벤트) 또는 WebSockets(WS) 위에서 MCP stdio 기반 서버를 단 하나의 명령어로 실행합니다. 이는 MCP 서버가 stdio만 지원할 때 원격 접속, 디버깅, 클라이언트 연결에 유용합니다.

질문, 아이디어, 아니면 그냥 대화하고 싶으신가요? 디스코드 커뮤니티에 참여하세요.

지원:

Supercov — 코딩 에이전트 및 소프트웨어 공장 🌙 커버리지
슈퍼인터페이스
슈퍼코프

설치 및 사용

npx를 통해 슈퍼게이트웨이를 실행하기:

--stdio "command": stdio에서 MCP 서버를 실행하는 명령어
--sse "https://mcp-server-ab71a6b2-cd55-49d0-adba-562bc85956e3.supermachine.app": SSE URL (SSE→stdio 모드)
--streamableHttp "https://mcp-server.example.com/mcp": 연결할 수 있는 스트리밍 가능한 HTTP URL (스트림블레→stdio 모드)
--outputTransport stdio | sse | ws | streamableHttp: 출력 MCP 전송(기본값: sse와 --stdio, stdio과 --sse 또는 [--streamableHttp]). --sse 또는 --streamableHttp로 제공된 원격 서버는 sse, ws 또는 streamableHttp를 통해서도 서비스를 제공할 수 있습니다; SSE, WS 또는 Streamable HTTP → 원격 서버를 참조하세요

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

README

원문 README의 일부입니다. 원문 보기.

Supergateway runs MCP stdio-based servers over SSE (Server-Sent Events) or WebSockets (WS) with one command. This is useful for remote access, debugging, or connecting to clients when your MCP server only supports stdio.

Questions, ideas or just want to chat? Join the community on Discord.

Supported by:

Supercov — Coverage for coding agents and software factories 🌙
Superinterface
Supercorp

Installation & Usage

Run Supergateway via npx:

npx -y supergateway --stdio "uvx mcp-server-git"

--stdio "command": Command that runs an MCP server over stdio
--sse "https://mcp-server-ab71a6b2-cd55-49d0-adba-562bc85956e3.supermachine.app": SSE URL to connect to (SSE→stdio mode)
--streamableHttp "https://mcp-server.example.com/mcp": Streamable HTTP URL to connect to (StreamableHttp→stdio mode)
--outputTransport stdio | sse | ws | streamableHttp: Output MCP transport (default: sse with --stdio, stdio with --sse or --streamableHttp). A remote server given with --sse or --streamableHttp can be served over sse, ws or streamableHttp too; see Remote server → SSE, WS or Streamable HTTP
--port 8000: Port to listen on (stdio→SSE, stdio→WS or stdio→Streamable HTTP mode, default: 8000)
--host 127.0.0.1: Address to listen on, e.g. 127.0.0.1 or ::1 ([::1] also works) (stdio→SSE, stdio→WS or stdio→Streamable HTTP mode, default: every interface). --baseUrl does not control binding: only --host limits which addresses accept connections. Refused in SSE→stdio and Streamable HTTP→stdio mode, which listen on nothing
--baseUrl "http://localhost:8000": Base URL for SSE clients (stdio→SSE mode; optional)
--ssePath "/sse": Path for SSE subscriptions (stdio→SSE mode, default: /sse)
--messagePath "/message": Path for messages (stdio→SSE or stdio→WS mode, default: /message)
--streamableHttpPath "/mcp": Path for Streamable HTTP (stdio→Streamable HTTP mode, default: /mcp)
--stateful: Run stdio→Streamable HTTP in stateful mode
--sessionTimeout 60000: Session timeout in milliseconds (stateful stdio→Streamable HTTP mode only)
--protocolVersion "2025-06-18": Protocol version the gateway uses when it initializes the server itself and the client’s request doesn’t name one (stateless stdio→Streamable HTTP mode, default: 2024-11-05)

GitHub에서 전체 README 보기

설치

uvx mcp-server-git

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "port": 8000,
  "mcpServers": {
    "git": { "command": "uvx", "args": ["mcp-server-git"] },
    "files": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./my-folder"],
      "outputTransport": "streamableHttp",
      "apiKey": "${FILES_KEY}",
    },
  },
}