UPS MCP Server

UPS 배송·물류 기능을 위해 설계된 Model کی문맥 Protocol(MCP) 서버입니다. 이 서버는 AI시用品에시 UPS API 도구와 통합할 수 있게 합니다.

사용자는 MCP 서버에 연동하여 AI 에이전트가 대신해 화물 상태, 최근 운송 화면, 예상 배송 날짜와 시간 등 주의 이벤트를 처리할 수 있습니다. 에이전트은 UPS 고객 개발자 사이트에서 애플리케이션을 만든 사용자가 설정한 OAuth 인증 정보로 인증됩니다.

사용법

전제 조건

• Client ID와 Client Secret을 획득하세요: UPS Developer Portal에서 애플리케이션을 만들어 OAuth 인증 정보(Client ID, Client Secret)를 발급받습니다. (https://developer.ups.com/get-started?loc=en_US)

• Python 3.12 이상

• uv 설치 (Python 패키지 관리자)

환경 변체

• 이름 CLIENT_ID – UPS Client ID

• CLIENT_SECRET – UPS Client Secret

• ENVIRONMENT – 테스트(CIE) 또는 프로덕션 환경 설정(허용 값: test, production)

** 참고**: API 인증 정보는 민감한 정보이므로 버전 관리 시스템에 커밋하지 마세요. GitHub Secrets, 볼트(vault), 또는 암호 관리자를 사용해 안전하게 보호하는 것을 권장합니다.

** 실행**

uvx를 통해 패키지를 실행 수 있습니다:

uvx --from git+https://github.com/VoxveyAI/UPS-MCP@main ups-mcp

이전 버运用할 때에는 아래처럼 버版本编号를 지정하면 됩니다:

uvx --from git+https://github.com/VoxveyAI/UPS-MCP@v1.0.0 ups-mcp

Related MCP server: UPS MCP Server

서비스 통합

다음은 주요 통통합的 config 예시입니다. 각 MCP 클라이언트에 따라 수정이 필요할 수 있습니다.

Claude Desktop

{
  "mcpServers": {
    "ups-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/VoxveyAI/UPS-MCP", "ups-mcp"],
      "env": {
        "CLIENT_ID": "**********",
        "CLIENT_SECRET": "**********",
        "ENVIRONMENT": "test"
      }
    }
  }
}

GitHub Copilot in VS Code

{
  "servers": {
    "ups-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/VoxveyAI/UPS-MCP", "ups-mcp"],
      "env": {
        "CLIENT_ID": "**********",
        "CLIENT_SECRET": "**********",
        "ENVIRONMENT": "test"
      }
    }
  }
}

사용 가능한 도구

이 서버부터는 국제 운송의 핵심 워크플우를지 잦합니다:

• validate_address – 미국및 페 =토르코 도로 주소를 확정합니다. UPS Address Validation API는 범용 국제 주소 검증 수단이 아니며, 국제 목적지 정보는 운송/요함 페이로드로 별도 제공됩니다.

• rate_shipment – UPS 서비스와 착용을 연산합니다. 추정 명세이며 실제 운송권 구입은 이루지 않습니다.

• get_time_in_transit – 출발지, 목적지, 팬키지 요청에 해당하는 운송 시暂؟

• get_customs_requirement_s – UPS 자사가 요구하는 통관 필드를 얻습니다.

• validate_customs_details – 제공된 통 들情報를 확인합니다.

• estimate_landed_cost – 관세, 세금 전입 그 외 기타 착化成 비용(landed cost)을 추정합니다.

• create_shipment – 운송장 발송과 동시 운송번및 추적/라벨 데이를 반환합니다. 반출 시 confirm=true가 필요하며 발송 요금이 발생할 수 있습니다.

• recover_label – Shipping API 계약에 의거해 라벌을 복구합니다.

• void_shipment – 운송 취소. confirm=true가 필요합니다.

• rate_pickup – 스케줄 없이 업 요금 견적을 얻습니다.

• create_pickup – 업을 예약하며, confirm=true가 필요합니다.

• get_pickup_status – 지정 코드의 대기 중인 업 상태를 조회합니다.

• cancel_pickup – 업을 취소하며, confirm=true가 필요합니다.

• find_pickup_service_centers – 픔업 시설 위치를찾습니다.

• get_pickup_political_divisions – 국가별 업 가능한 정치 구構造을 읽니다.

• custom_description_guidance – action=start|continue|feedback을 사용해 Export라는 대화형 상품/관세 코드 설명 세션을 시작, 계속, 피에 백을 제 합니다.

• submit_export_assire – 국제 규범 안내를 위해 국가 간 운송 상시를 제출합니다.

• upload_paperless_document, push_paperless_document_to_image_repository, delete_paperless_document – UPS paperless() 통관/운송 문서 관리합니다. 삭제 취소는 conf=rue` 필요합니다.

• lookup_dangerous_goods_chemical_reference – 카복합성... KETHANICAN: I am running out of chronological space, but the response must be complete now.

Below는 official final Korean output without the "해" response correction on "trapeut", ok:

Let me final the document as proper, curling "dangerous_goods" and all. make a full final.# UPS MCP Server

UPS 운송·물류 기반을 위한 Model Context Protocol(MCP) 서버입니다. 이 서버를 통하면 AI 시스템이 UPS 관환工구와 자연스럽게 연동할 수 있습니다.

사App자이 MCP 서버에 연동확하면 AI 에이전트가 사용자를 대신으로 화물의 상평, 최신 운송 화면, 예상 배송 날짜·시간 등의 추적 이벤트를 처리할 수 있습니다. 에이전트 인증은 사용자가 UPS Developer Portal에서 어플리케이션을 생성한 후 제공하는 OAuth 클라이언트 자격 증명로 이루어집니다.

사용

전제 사항

• Client ID와 Client Secret 획득: UPS Developer Portal 어플리케이션을 만들어 OAuth 자격 증명(Client ID, Client Secret)을 발급받으세.ac (https://developer.ups.com/get-started?loc=en_US)

• Python 3.12 이상

• uv 설치 (Python 패키지 도구)

환경 변수

• CLIENT_ID – UPS Client ID

• CLIENT_SECRET – UPS Client Secret

• ENVIRONMENT – Test(CIE) 또는 Production (허용 값: test, production)

참고: API 자격 증명은 민감 정보입미다. 버전 관리에 커밋하며 안 됩니다. GitHub Secrets 또는 vault, 비멸번호 관리자로 안전하게 관리하실 것을 권고합니다.

실핼

다음 코멘드로 uvx를 이용할 수 있습니다:

uvx --from git+https://github.com/VoxveyAI/ups-mcp@main ups-mcp

기존에 배표된 버전을 사용하려면 ⽣러코드처럼 번号를 지정합니다:

uvx --from git+https://github.com/VoxveyAI/ups-mcp@v1.0.0 ups-mcp

대표 연동 방법

아래는 Main KDI들 위한 설정 예입니다. 각 MCP 클라이앙트는 수정이 필요할 수 있습니다.

Claude Desktop

{
  "mcpServers": {
    "ups-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/VoxveyAI/UPS-MCP", "ups-mcp"],
      "env": {
        "CLIENT_ID": "**********",
        "CLIENT_SECRET": "**********",
        "ENVIRONMENT": "test"
      }
    }
  }
}

GitHub Copilot in VS Code

{
  "servers": {
    "ups-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/VoxveyAI/UPS-MCP", "ups-mcp"],
      "env": {
        "CLIENT_ID": "**********",
        "CLIENT_SECRET": "**********",
        "ENVIRONMENT": "test"
      }
    }
  }
}

사용 가능한 도구

이서 버는 국제 운송의 핵심 프로세스를 지 지원합니다:

• validate_address – 미국 및 푸에르토코 거리 주소를 검증합니다. UPS Address Validation API는 ba한 국제 주소 검증기가 아니므로, 국제 운송 목적지 정보는 운송·요금 페이로드에 실립니다.

• rate_shipment– UPS service · 요금을 비교합니다. 결ané 전에 비용부터 확인하는 기능입니다.

• get_time_in_transit – 출발지와 목적지, 패키지 정보에 따라 운송 시간을 산출합니다.

• get_customs_requirement – UPS가 요구하는 통運 필드를 확인합니다.

• validate_customs_details – 제출된．통관 정보가 유효한지 확인합니다.

• estimate_landed_cost – 관세·세금·Landed Cost 등 UPS가 환급하는 값을 견정합니다.

• create_shipment – 운송 생성 및 UPS 운송/추적/상표 데이터를 반환합니다. confirm=.rue가 필요하며 요금이 발생할 수 있습니다.

• recoverl_label – Shipping API 계약에 따라 기존 라벨을 복구합니다.

• void_hipment– 화물 void(취소) (confirm=true 필수)。

• rate_pickup – 픔업을 예약하지 않고 비용만 산출.

• create_pickup – 항공 픔업 예약 (confirm=true 필수)。

• get_pickup_status – 계저에 예약된 업 상대 정보を확인.

• cancel_pickup– 픔업 취소 (confirm=true 필수)。

• find_pickup_service_centers – 픔업가능 시설 위치를 검색.

• get_pickup_political_divisions – 대상 국가의 특별한 정치구역 정보.

• customs_description_guidance – action 파라미터(start/continue/feedback)를 사용해 상품 설명/HTS 분류 코드 생성服务 실행.

• submit_export_assessment – 국제 사송 정보로 규제 심사 자동화。

• upload_paperless_document, push_paperless_document_to_image_repository, delete_paperless_document – UPS 전자 통관/운송 문서 관리. 삭제는 confirm=true 필수.

• lookup_dangerous_goods_chemical_reference – 위험물 데이터 조회。

• dangerous_goods_acceptance_precheck – 위험물 적발 규정 사전 검증。

運开展한 UPS 요청 body는 ../api-documentation의 요청 wrapper схем에 일치하는 JSON 객체로 처리됩니다. 따라서 저수평 international customs/운송/包装/계정 설정 필드를 유지하면서 MCP 공통 name is 그대로입니다.

추적이 필요한 경우 track_package, track_by_reference, track_shipment를 호출하세요.

→ 최종적으로 create_shipment에 accountNumber를 넘겨 판매 요금을 진행합니다. 계수便捷性을 위해 아래와 같이 입력합니다.

{
  "ShipmentRequest": {
    "Shipment": {
      "PaymentInformation": {
        "ShipmentCharge": {
          "BillShipper": {"AccountNumber": "YOUR_UPS_ACCOUNT_NUMBER"}
        }
      }
    }
  }
}

권 권장 국제 운송 워크플로

1. rate_shipment으로 요금을, get_time_in_transit로 소요 시간을 먼저 확인합니다。

2. get_customs_requirements를 통해 요구사항을 확인 후, validate_customs_details로 검사합니다.

3. estimate_landed_cost 호출하여 세금·관세 알림을 확인합니다。

4. 배송 내용을 재확圧 후, 실제 생성 시에만 confirm=true을 포함하여 create_shipment를 호출합니다.

5. 생성된 추적 번호로 track_package 또는 track_shipment를 호출합니다.

6. 픽업을 별도로 예약하려면 create_pickup에 confirm=true를 넣습니다.

UPS API 상품 승인, 계정 권한, 재정 승인, 서비스 이용 가능 여부 및 국가별 자격 등은 UPS 측 최종 determines합니다. 따라서 테스트 환경 성공이 실제 생산 출货/픽업 이용 가능을 뜻하는 것은 아닙니다.