Shiplogic MCP 서버

Shiplogic 운송 API와의 원활한 통합을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. MCP SDK와 TypeScript를 기반으로 설계되어 타입 안전성과 향상된 개발자 경험을 제공합니다.

데모

지엑스피1

특징

🚚 배송비 받기 - 주소 간 배송비 계산
📦 배송 생성 - 자동 추적으로 배송 예약
🔍 패키지 추적 - 실시간 배송 추적
❌ 배송 취소 - 필요한 경우 예약 취소
➕ 선택 서비스 - 특별 서비스에 대한 추가 요금에 액세스하세요
📚 주소록 관리 - 자주 사용하는 주소를 저장하고 관리하세요

설치

필수 조건

노드.js 18+
npm 또는 yarn
Shiplogic API 키( shiplogic.com 에서 받으세요)

빠른 시작

복제하고 설치하세요:

git clone https://github.com/jlwainwright/shiplogic-mcp.git
cd shiplogic-mcp
npm install

환경 구성:

cp .env.example .env
# Edit .env and add your Shiplogic API key

서버를 빌드하세요:

npm run build

용법

클로드 데스크톱과 함께

Claude Desktop 구성에 다음을 추가하세요.

{
  "mcpServers": {
    "shiplogic": {
      "command": "node",
      "args": ["/absolute/path/to/shiplogic-mcp/dist/index.js"],
      "env": {
        "SHIPLOGIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

MCP 검사관과 함께

MCP Inspector를 사용하여 서버를 테스트합니다.

npm run inspect

독립형

서버를 직접 실행합니다.

npm run dev

사용 가능한 도구

`get_shipping_rates`

두 주소 사이의 배송료를 계산합니다.

{
  collection_address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business"
  },
  delivery_address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business"
  },
  parcels: [{
    length: number,    // cm
    width: number,     // cm
    height: number,    // cm
    weight: number,    // kg
    description?: string
  }],
  declared_value?: number
}

`create_shipment`

추적 기능이 있는 새로운 배송물을 생성합니다.

{
  service_level_code: string,  // e.g., "ECO"
  collection_address: { /* same as above */ },
  delivery_address: { /* same as above */ },
  parcels: [{ /* same as above */ }],
  collection_contact: {
    name: string,
    mobile_number?: string,
    email?: string
  },
  delivery_contact: {
    name: string,
    mobile_number?: string,
    email?: string
  },
  customer_reference?: string,
  mute_notifications?: boolean
}

`track_shipment`

참조 번호로 배송물을 추적하세요.

{
  tracking_number: string
}

`cancel_shipment`

기존 배송을 취소합니다.

{
  tracking_reference: string
}

`get_opt_in_rates`

선택적으로 추가 서비스 요금을 받으세요.

{
  collection_address: { /* address object */ },
  delivery_address: { /* address object */ }
}

`add_address_to_book`

계정 주소록에 주소를 추가합니다.

{
  account_id: number,
  address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business",
    company?: string
  },
  name?: string,            // Name for this address entry
  type?: "collection" | "delivery"  // Address type
}

`get_address_book`

계정 주소록에서 주소를 검색합니다.

{
  account_id: number,
  type?: "collection" | "delivery"  // Optional filter by type
}

`remove_address_from_book`

계정 주소록에서 주소를 제거합니다.

{
  account_id: number,
  address_id: number
}

구성

환경 변수:

변하기 쉬운	설명	필수의	기본
`SHIPLOGIC_API_KEY`	Shiplogic API 키	예	-
`SHIPLOGIC_API_URL`	API 기반 URL	아니요	`https://api.shiplogic.com`

개발

프로젝트 구조

shiplogic-mcp-official/
├── src/
│   └── index.ts        # Main server implementation
├── dist/               # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

스크립트

npm run build - TypeScript 컴파일
npm run dev - 빌드하고 실행
npm run inspect - MCP Inspector로 실행

테스트

# Run with MCP Inspector
npm run inspect

# In another terminal, test the tools
curl -X POST http://localhost:3000/tools/list

API 참조

이 서버는 Shiplogic API v2와 통합되어 있습니다. 자세한 API 문서는 다음을 참조하세요.

특허

MIT 라이선스 - LICENSE 파일 참조

기여하다

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항 커밋( git commit -m 'Add amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

지원하다

🐛 문제: GitHub 문제
📧 이메일: your.email@example.com
📚 문서: 위키
☕ 내 작업을 지원해주세요: 커피 한 잔 사주세요

이 프로젝트가 도움이 되셨다면 제 작업을 후원해 주세요. 여러분의 후원은 제가 오픈 소스 개발에 더 많은 시간을 할애하고 커뮤니티를 위한 더 나은 도구를 만드는 데 도움이 됩니다.

감사의 말

모델 컨텍스트 프로토콜 SDK 로 구축됨
Shiplogic API 기반

Jacques Wainwright가 ❤️로 만들었습니다

Shiplogic MCP Server

Integrations