Terminal.shop MCP Server

by pashaydev

Integrations

  • Serves as the runtime environment for the Terminal.shop MCP server, enabling product browsing, cart management, order placement, and subscription handling through Terminal.shop's API.

  • Facilitates secure payment processing for Terminal.shop, allowing for adding payment methods using Stripe tokens and collecting card information through secure URLs.

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

Configuración

Prerrequisitos

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

Instalación

  1. Clonar este repositorio
  2. Instalar dependencias:
    npm install
  3. Conéctese a Terminal.shop y cree un nuevo token:
    ssh terminal.shop -t tokens
  4. 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" } } } }
  1. Reinicie claude.app y asegúrese de ver el ícono del martillo debajo de la entrada.
  2. 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

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Permite que los asistentes de IA interactúen sin problemas con Terminal.shop para explorar productos, administrar carritos de compra, realizar pedidos y gestionar suscripciones a través de la API de Terminal.shop.

  1. Características
    1. Configuración
      1. Prerrequisitos
      2. Instalación
    2. Recursos disponibles
      1. Herramientas
        1. Herramientas de producto
        2. Herramientas para carrito
        3. Herramientas de pedido
        4. Herramientas de gestión de usuarios
        5. Herramientas de suscripción
        6. Herramientas de cuenta
      2. Plantillas de indicaciones
        1. Documentación de la API
          1. Consideraciones de seguridad
            1. Licencia

              Related MCP Servers

              • -
                security
                F
                license
                -
                quality
                Enables AI assistants to interact with Metabase databases and dashboards, allowing users to list and execute queries, access data visualizations, and interact with database resources through natural language.
                Last updated -
                9
                JavaScript
                • Apple
              • -
                security
                F
                license
                -
                quality
                Enables AI assistants to interact with Metabase, providing access to dashboards, questions, databases, and tools for executing queries and viewing data through natural language.
                Last updated -
                JavaScript
                • Apple
              • -
                security
                F
                license
                -
                quality
                Provides AI assistants with access to Payman's documentation, helping developers build integrations more efficiently through enhanced contextual support.
                Last updated -
                TypeScript
              • -
                security
                A
                license
                -
                quality
                Allows AI assistants to safely execute common Unix/macOS terminal commands through a controlled interface with comprehensive security features.
                Last updated -
                Python
                MIT License

              View all related MCP servers

              ID: swj874kcc4