Duffel MCP Server

AI 어시스턴트에게 Duffel 여행 API에 대한 타입이 지정된 도구 계층을 제공하는 Model Context Protocol 서버입니다. 모델이 스스로 상상하여 생성한 것이 아니라 실시간 재고에서 검색된 항공편, 숙박, 렌터카를 다룹니다.

공식 Anthropic MCP SDK를 기반으로 TypeScript로 구축되었습니다. stdio를 통해 실행되므로 Claude Desktop이나 MCP 호환 클라이언트에 바로 연결할 수 있습니다.

검색 전용입니다. 이 서버는 예약, 결제 또는 개인 데이터 표면을 노출하지 않습니다. 가용성과 가격을 읽을 뿐이며, 비용을 지출하거나 예약할 수 없습니다.

왜 존재하는가

여행은 에이전트 AI의 좋은 시험 사례입니다. 질문은 자연어("5월에 리스본으로 일주일, 800파운드 이하")이지만, 답은 실제 재고와 실제 가격에서 나와야 하기 때문입니다. 언어 모델은 항공편 일정을 만들어낼 수 없습니다. 도구가 필요합니다.

이 서버는 네 가지 도구를 제공하며, 모델이 추측 없이 연결할 수 있도록 구성되어 있습니다.

Related MCP server: Travel Assistant MCP

도구

설계의 핵심은 resolve_place입니다. 이것이 없으면 모델은 리스본이 LIS라고 추측하고 좌표를 지어내야 합니다. 이것이 있으면 모든 다운스트림 호출은 실제 식별자에 기반합니다.

주목할 만한 설계 결정 사항

• 시작 시 자격 증명을 확인합니다. DUFFEL_API_KEY가 설정되지 않으면 첫 번째 도구 호출에서 혼란스럽게 실패하는 대신 프로세스가 stderr에 로그를 남기고 0이 아닌 종료 코드로 종료됩니다.

• stdout은 MCP 프로토콜 전용입니다. 모든 로깅은 stderr로 이동합니다. 다른 것을 stdout에 쓰면 JSON-RPC 스트림이 손상됩니다. 이는 명시적으로 설계해야 하는 미묘한 실패 모드입니다.

• 스모크 테스트에서 테스트 토큰을 강제합니다. test/smoke.ts는 토큰이 duffel_test_로 시작하지 않으면 실행을 거부하므로 실수로 라이브 토큰을 사용할 수 없습니다. 토큰을 절대 인쇄하지 않습니다.

• 예약 기능이 없습니다. 예약 및 결제 엔드포인트는 의도적으로 노출하지 않습니다. 이 서버를 사용하는 에이전트는 여행을 조사할 수 있지만, 여행을 강제로 결정할 수는 없습니다.

요구 사항

• Node.js 18+

• Duffel 테스트 토큰 — app.duffel.com → 개발자 → 액세스 토큰에서 무료로 받을 수 있습니다.

설정

npm install
cp .env.example .env   # then add your Duffel test token
npm run build

실행

npm run dev     # development, via tsx
npm start       # production, from dist/

Claude Desktop에서 사용하기

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "duffel-travel": {
      "command": "node",
      "args": ["/absolute/path/to/duffel-mcp/dist/index.js"],
      "env": { "DUFFEL_API_KEY": "duffel_test_your_token_here" }
    }
  }
}

Claude Desktop을 다시 시작하면 네 가지 도구가 나타납니다. 시도해 보세요: "5월에 에든버러에서 리스본으로 가는 항공편과 시내 중심가 근처에 머물 곳을 찾아줘."

테스트

npx tsx --env-file=.env test/smoke.ts

라이브 Duffel 테스트 API에 대해 resolve_place 및 search_flights를 호출합니다. 실패하면 0이 아닌 종료 코드로 종료되며 토큰을 절대 인쇄하지 않습니다.

아키텍처

src/
├── index.ts    entry point — credential guard, stdio transport
├── server.ts   MCP server: registers the four tools with zod schemas
└── duffel.ts   Duffel API client and response normalisation

응답은 모델에 도달하기 전에 정규화됩니다. 원시 Duffel 페이로드는 크고, 에이전트는 깊게 중첩된 API 응답보다 다듬어지고 예측 가능한 형태에서 더 잘 추론합니다.

기술

TypeScript · @modelcontextprotocol/sdk · @duffel/api · zod

출처

2026년 Orbixio Ltd(영국, 회사 번호 16587877)의 AI 여행 제품인 Tourista의 도구 계층으로 Ahmed Ali Qadir이(가) 구축했습니다. 독립적이고 재사용 가능한 MCP 서버로 추출했습니다.

Duffel 또는 Anthropic과 제휴하거나 보증하지 않습니다.

라이선스

MIT — LICENSE 참조.