Terminal.shop MCP Server

Terminal.shop MCP 서버

이 프로젝트는 Terminal.shop과 상호작용하는 MCP 서버를 구현합니다. 이를 통해 AI 비서가 Terminal.shop의 API를 통해 제품을 원활하게 탐색하고, 장바구니를 관리하고, 주문을 하고, 구독을 처리할 수 있습니다.

특징

• 제품 관리 : Terminal.shop의 커피 제품을 탐색하고 검색하세요
• 장바구니 작업 : 장바구니에 상품 추가, 배송지 주소 및 결제 방법 설정
• 주문 관리 : 주문하고 주문 내역 보기
• 구독 처리 : 정기 커피 구독을 만들고 관리합니다.
• 사용자 프로필 : 사용자 정보 업데이트 및 배송 주소 관리
• 결제 방법 : 결제 정보의 안전한 처리

설정

필수 조건

• 노드.js
• Terminal.shop 계정
• Terminal.shop API 토큰

설치

1. 이 저장소를 복제하세요
2. 종속성 설치:지엑스피1
3. Terminal.shop에 연결하고 새 토큰을 만듭니다.
   ssh terminal.shop -t tokens
4. claude.app을 열고 설정으로 가서 '개발자' 옵션과 '구성 편집'을 클릭하세요:

6. claude.app을 다시 시작하고 입력 아래에 망치 아이콘이 있는지 확인하세요.
7. 클로드에게 제품 목록을 요청하거나 새 주소, 구독 등을 생성해 달라고 요청하세요.

사용 가능한 리소스

MCP 서버는 다음과 같은 리소스를 제공합니다.

• terminal://products - 사용 가능한 모든 제품 나열
• terminal://product/{id} - 특정 제품에 대한 세부 정보를 가져옵니다.
• terminal://orders - 주문 내역 보기
• terminal://profile - 사용자 프로필 정보에 접근합니다
• terminal://addresses - 배송 주소 관리
• terminal://cards - 결제 방법 관리
• terminal://cart - 현재 쇼핑 카트 보기
• terminal://subscriptions - 커피 구독 관리

도구

이 서버는 Terminal.shop과 상호작용하기 위한 다양한 도구를 제공합니다.

제품 도구

• search-products - 키워드로 제품 검색
• get-product-details - 특정 제품에 대한 자세한 정보를 가져옵니다.

카트 도구

• add-to-cart - 장바구니에 제품 변형 추가
• set-cart-address - 장바구니의 배송 주소를 설정합니다.
• set-cart-card - 장바구니의 결제 방법을 설정합니다.
• clear-cart - 장바구니 비우기
• checkout - 장바구니를 주문으로 전환

주문 도구

• create-order - 장바구니를 사용하지 않고 직접 주문을 생성합니다.

사용자 관리 도구

• update-profile - 사용자 프로필 정보 업데이트
• create-address - 새로운 배송 주소 추가
• delete-address - 배송 주소 제거
• collect-card - 결제 정보 추가를 위한 보안 URL 생성
• create-card - Stripe 토큰을 사용하여 카드 추가
• delete-card - 결제 수단 제거

구독 도구

• create-subscription - 새로운 커피 구독을 시작하세요
• cancel-subscription - 기존 구독 취소

계정 도구

• create-token - 새로운 개인 액세스 토큰을 만듭니다.
• delete-token - 개인 액세스 토큰 삭제
• get-app-data - 모든 계정 데이터를 한 번에 가져오기

프롬프트 템플릿

서버에는 AI 도우미가 더 나은 응답을 제공하는 데 도움이 되는 여러 가지 프롬프트 템플릿이 포함되어 있습니다.

• browse-products - 제품 탐색 및 찾기 가이드
• manage-cart - 쇼핑 카트 관리 도움말
• place-order - 주문하기 지원
• manage-subscription - 구독 관리 지원
• manage-profile - 프로필 및 주소 관리 가이드

API 문서

이 MCP 서버는 Terminal.shop API를 기반으로 구축되었습니다. 기본 API에 대한 자세한 내용은 Terminal API 문서를 참조하세요.

보안 고려 사항

• 서버는 카드 정보를 직접 처리하는 대신 보안 URL을 통해 민감한 결제 정보를 처리합니다.
• API 토큰은 노출을 방지하기 위해 환경 변수에 저장됩니다.
• 사용자 데이터는 Terminal.shop의 보안 관행에 따라 처리됩니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.