Servidor MCP de Terminal.shop

Este proyecto implementa un servidor mcp para interactuar con terminal.shop. Permite a los asistentes de IA explorar productos, gestionar carritos de compra, realizar pedidos y gestionar suscripciones sin problemas a través de la API de Terminal.shop.

Características

Gestión de productos : navegue y busque los productos de café de Terminal.shop
Operaciones del carrito : agregar artículos al carrito, configurar la dirección de envío y el método de pago
Gestión de pedidos : realizar pedidos y ver el historial de pedidos
Manejo de suscripciones : cree y administre suscripciones de café recurrentes
Perfil de usuario : Actualizar la información del usuario y administrar las direcciones de envío
Métodos de pago : Manejo seguro de la información de pago

Related MCP server: Command-Line MCP Server

Configuración

Prerrequisitos

Node.js
Una cuenta de Terminal.shop
Un token de API de Terminal.shop

Instalación

Clonar este repositorio
Instalar dependencias:
```
npm install
```
Conéctese a Terminal.shop y cree un nuevo token:
```
ssh terminal.shop -t tokens
```
Abra claude.app, vaya a configuración, haga clic en la opción 'desarrollador' y 'editar configuración':

{
  "mcpServers": {
    "terminal-shop-mcp": {
      "command": "node",
      "args": ["path_to_folder/server.js"],
      "env": {
        "TERMINAL_API_TOKEN": "token here"
      }
    }
  }
}

Reinicie claude.app y asegúrese de ver el ícono del martillo debajo de la entrada.
Pídale a Claude que obtenga una lista de productos o cree una nueva dirección, suscripción, etc.

Recursos disponibles

El servidor MCP proporciona los siguientes recursos:

terminal://products - Lista todos los productos disponibles
terminal://product/{id} - Obtener detalles de un producto específico
terminal://orders - Ver historial de pedidos
terminal://profile - Acceder a la información del perfil del usuario
terminal://addresses - Administrar direcciones de envío
terminal://cards - Gestionar métodos de pago
terminal://cart - Ver el carrito de compras actual
terminal://subscriptions - Administrar suscripciones de café

Herramientas

El servidor proporciona varias herramientas para interactuar con Terminal.shop:

Herramientas de producto

search-products - Buscar productos por palabra clave
get-product-details : obtenga información detallada sobre un producto específico

Herramientas para carrito

add-to-cart - Añadir una variante de producto al carrito
set-cart-address - Establece la dirección de envío para el carrito
set-cart-card - Establece el método de pago para el carrito
clear-cart - Vaciar el carrito de compras
checkout - Convertir el carrito en un pedido

Herramientas de pedido

create-order - Crea un pedido directamente sin usar el carrito

Herramientas de gestión de usuarios

update-profile - Actualizar la información del perfil del usuario
create-address - Agregar una nueva dirección de envío
delete-address - Eliminar una dirección de envío
collect-card : genera una URL segura para agregar información de pago
create-card - Agregar una tarjeta usando un token de Stripe
delete-card - Eliminar un método de pago

Herramientas de suscripción

create-subscription - Iniciar una nueva suscripción de café
cancel-subscription - Cancelar una suscripción existente

Herramientas de cuenta

create-token - Crea un nuevo token de acceso personal
delete-token - Eliminar un token de acceso personal
get-app-data : recupera todos los datos de la cuenta a la vez

Plantillas de indicaciones

El servidor incluye varias plantillas de indicaciones para ayudar a los asistentes de IA a proporcionar mejores respuestas:

browse-products - Guía para explorar y encontrar productos
manage-cart - Ayuda con la gestión del carrito de compra
place-order - Asistencia para realizar un pedido
manage-subscription - Soporte para la gestión de suscripciones
manage-profile - Guía para la gestión de perfiles y direcciones

Documentación de la API

Este servidor MCP se basa en la API de Terminal.shop. Para obtener información detallada sobre la API subyacente, consulte la documentación de la API de Terminal.

Consideraciones de seguridad

El servidor maneja información de pago confidencial a través de URL seguras en lugar de procesar directamente los detalles de la tarjeta.
Los tokens API se almacenan en variables de entorno para evitar la exposición
Los datos del usuario se manejan de acuerdo con las prácticas de seguridad de Terminal.shop