Skip to main content
Glama
deenesjakoruzh
mkusaka

tmcproxy

by mkusaka
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

tmcproxy

OpenAI Secure MCP Tunnel / ChatGPT 커넥터를 레거시 stdio MCP 서버에 연결하는 최소한의 MCP stdio 호환성 프록시입니다.

이 프록시가 해결하는 문제

ChatGPT 커넥터(OpenAI Secure MCP Tunnel을 통해)는 server/discover로 stdio MCP 서버를 프로브합니다. 이 메서드는 MCP 2026-07-28에서 도입되었습니다. codex mcp-server 및 local-mcp mcp와 같은 레거시 서버는 2025-06-18만 지원하며 server/discover에 대해 method not found를 반환하여 커넥터 생성을 실패하게 합니다.

tmcproxy는 그 사이에 위치하여 다운스트림을 대신해 server/discover에 응답하고, 다른 모든 요청은 그대로 전달합니다.

ChatGPT → tunnel-client → tmcproxy → codex mcp-server (or local-mcp mcp)
                                ↑
                   answers server/discover here,
                   forwards everything else straight through

Related MCP server: MCP SSE Proxy

요구 사항

  • Node.js >= 23.6.0 (네이티브 TypeScript strip-mode 실행을 위해 — 빌드 단계 불필요)

사용법

독립 실행

node src/tmcproxy.ts -- codex mcp-server
node src/tmcproxy.ts -- local-mcp mcp

또는 환경 변수를 통해:

TMCPROXY_DOWNSTREAM="codex mcp-server" node src/tmcproxy.ts

tunnel-client와 함께 사용

tunnel-client 프로필 YAML을 편집하세요 (예: ~/.config/tunnel-client/<profile>.yaml):

mcp:
  commands:
    - channel: main
      command: "node /path/to/tmcproxy/src/tmcproxy.ts -- codex mcp-server"

그런 다음:

tunnel-client run --profile <profile>

다운스트림 전환은 -- 뒤의 명령만 변경하면 됩니다:

      command: "node /path/to/tmcproxy/src/tmcproxy.ts -- local-mcp mcp"

작동 방식

요청

동작

server/discover

프록시가 사양에 맞는 DiscoverResult로 응답합니다. 기능은 다운스트림에서 tools/list를 통해 프로브됩니다 (추측하지 않음).

initialize

다운스트림에 그대로 전달됩니다. 프록시는 자체적으로 initialize를 호출하지 않습니다. codex mcp-server는 정확히 한 번만 허용하므로 클라이언트의 핸드셰이크가 도달해야 합니다.

tools/list, tools/call, ping 등.

JSON-RPC id를 유지한 채 그대로 전달됩니다.

알림 (id 없음)

전달됨; 응답이 예상되지 않습니다.

잘못된 형식의 JSON

-32700 Parse error가 업스트림에 반환되며 전달되지 않습니다.

알 수 없는 메서드

전달됨; 다운스트림 오류가 다시 흘러갑니다.

supportedVersions에 2026-07-28이 포함된 이유

ChatGPT는 2026-07-28로 프로브합니다. 응답에 2025-06-18만 나열되면 ChatGPT는 이를 "요청한 버전이 지원되지 않음"으로 간주하고 무한히 재시도하여 initialize 또는 tools/list에 도달하지 못합니다. 2026-07-28을 나열함으로써 ChatGPT는 최신 모드로 진입하여 상태 비저장 요청(tools/list, tools/call)을 직접 보냅니다. 레거시 다운스트림은 사전 initialize 없이도 이에 응답하므로(codex mcp-server 및 local-mcp mcp 모두 확인됨), 투명한 전달이 작동합니다.

디버깅

디버그 로그

TMCPROXY_DEBUG=1을 설정하여 server/discover 요청 및 응답을 stderr에 기록합니다:

TMCPROXY_DEBUG=1 tunnel-client run --profile local-codex

stderr에 출력 (stdout은 깨끗하게 유지 — MCP 채널입니다):

[tmcproxy] downstream: ["codex","mcp-server"]
[tmcproxy] discover request: {"jsonrpc":"2.0","id":"openai-mcp-discover",...}
[tmcproxy] discover response: {"resultType":"complete","supportedVersions":["2026-07-28","2025-06-18"],...}

로컬 종단 간 테스트 (API 키 불필요)

tunnel-client dev proxy는 ChatGPT가 사용하는 것과 동일한 MCP 프로브 흐름을 재현하는 로컬 인메모리 제어 플레인을 실행합니다:

tunnel-client dev proxy \
  --mcp-command "command=node /path/to/tmcproxy/src/tmcproxy.ts -- codex mcp-server,channel=main" \
  --url-file /tmp/url.json \
  --duration 30s

MCP_URL=$(node -e "console.log(JSON.parse(require('fs').readFileSync('/tmp/url.json','utf8')).mcp_url)")
curl -sS -X POST "$MCP_URL" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: server/discover' \
  -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}'

기준 비교

프록시가 필요한지 확인하려면 다운스트림을 dev proxy를 통해 직접 실행하고 server/discover 실패를 관찰하세요:

tunnel-client dev proxy \
  --mcp-command "command=codex mcp-server,channel=main" \
  --url-file /tmp/url.json --duration 30s
# server/discover → -32601 method not found

테스트

pnpm install
pnpm test          # unit + integration
pnpm test:unit     # mock downstream only
pnpm test:integration  # real codex / local-mcp (auto-skipped if not installed)
pnpm typecheck

단위 테스트는 모의 다운스트림(test/fixtures/mock-downstream.js)을 사용하며 다음을 포함합니다: discover 응답 형태, 기능 프로빙, initialize 전달, tools/list, tools/call id 보존, ping, 알 수 없는 메서드, 잘못된 형식의 JSON, 알림, stderr 미러링, 다운스트림 종료 처리, stdout 누수 감지.

통합 테스트는 PATH에서 사용 가능한 경우 실제 codex mcp-server 및 local-mcp mcp 바이너리를 실행합니다.

보안

  • 진단 정보는 stderr로만 전송됩니다; stdout은 MCP 트래픽용으로 예약됩니다.

  • 자격 증명, API 키 또는 비밀은 기록되지 않습니다.

  • 다운스트림은 argv를 통해 생성됩니다 (셸 사용 안 함).

  • 프록시는 server/discover만 처리합니다; 다른 모든 요청은 변경 없이 통과합니다.

  • 프록시는 다운스트림의 권한을 확장하지 않습니다.

라이선스

Apache-2.0

This server cannot be deployed

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • openai-tool2mcp

    alohays
    A
    license
    B
    quality
    F
    maintenance
    A lightweight bridge that wraps OpenAI's built-in tools (like web search and code interpreter) as Model Context Protocol servers, enabling their use with Claude and other MCP-compatible models.
    4
    12
    MIT

  • MCP SSE Proxy

    gomarble-ai
    F
    license
    Not graded
    quality
    Not graded
    maintenance
    Bridges STDIO-based MCP clients with SSE-based MCP servers, allowing applications like Claude Desktop to connect to remote MCP servers that use SSE transport.
    9
    -

  • rustunnel-mcp

    joaoh82
    A
    license
    A
    quality
    A
    maintenance
    MCP (Model Context Protocol) server for rustunnel. Lets AI agents (Claude Code, Cursor, Windsurf) create and manage public tunnels to local services from inside an agent session.
    6
    660
    AGPL 3.0