메인 콘텐츠로 건너뛰기
Bridger는 OpenAPI 기반 데이터 소스를 MCP 도구로 변환하고, 하나의 Gateway에서 인증·라우팅·감사 흐름을 처리합니다. 사용자는 별도 서버를 운영하지 않고 Gateway 엔드포인트를 호출합니다.

구성요소

Gateway

MCP JSON-RPC, SSE, Registry API를 노출하는 실행 계층입니다.

Tool Registry

프리셋과 BYOAPI 등록 도구의 스키마, 권한, 라우팅 정보를 관리합니다.

Public Data Adapter

공공데이터 인증키 주입, 좌표 변환, XML/JSON 정규화, 에러 매핑을 처리합니다.

Admin Dashboard

API 키, Provider Keys, 감사 로그를 관리합니다.

런타임 데이터 흐름

   클라이언트 (Claude · Cursor · ChatGPT · 커스텀 앱)

        │  MCP JSON-RPC / SSE / REST

   ┌──────────────────────────────────────────────┐
   │            Bridger Gateway               │
   ├──────────────────────────────────────────────┤
   │  1. 인증            (API Key / OAuth 2.0)     │
   │  2. 테넌트 격리                                │
   │  3. 요청 제어                                  │
   │  4. JSON-RPC 디스패치                          │
   │     ├─ tools/list → Registry 조회              │
   │     └─ tools/call → ID 라우팅 → Upstream Proxy │
   │  5. 공공데이터 어댑터                           │
   │     ├─ ServiceKey 자동 주입                    │
   │     ├─ 위경도 → 격자좌표 변환                   │
   │     └─ XML/JSON 정규화                         │
   │  6. PII 필터링                                  │
   │  7. 감사 로그 기록                              │
   │  8. SSE 이벤트 브로드캐스트                     │
   └──────────────────────────────────────────────┘


   외부 API (공공데이터포털 · 3rd-party SaaS · 직접 등록한 API)

프리셋 구조

프리셋은 OpenAPI 스펙과 공공데이터 메타데이터를 함께 가진 도구 정의입니다.
openapi: "3.0.3"
info:
  title: 기상청 초단기예보 API
  description: ...
  version: "1.0"
x-publicdata:
  provider: 기상청
  dataGoKrId: "15070051"
servers:
  - url: https://apis.data.go.kr/...
paths:
  /getUltraSrtFcst:
    get:
      operationId: getUltraSrtFcst
      summary: 초단기예보 조회
      parameters: [...]

다음 단계

BYOAPI

임의의 OpenAPI 스펙을 도구로 등록하는 흐름.

인증·보안

API Key, 시크릿, PII 필터, 감사 로그.