Sychev Lab MCP Server

Servidor MCP (Model Context Protocol) para Sychev Lab - proporciona acceso a productos, artículos, tutoriales y funciones de comercio electrónico.

Características

• Catálogo de Productos: Listar, buscar y obtener detalles de productos STL para impresión 3D
• Artículos: Acceso a artículos técnicos y de blog
• Tutoriales: Tutoriales paso a paso con información de dificultad y duración
• Categorías: Navegación por categorías de productos
• Usuarios: Registro de nuevos usuarios
• Checkout: Creación de sesiones de pago con Stripe

Herramientas Disponibles

Herramienta	Descripción
list_products	Lista todos los productos disponibles
get_product_details	Obtiene información detallada de un producto
search_products_by_category	Busca productos por categoría o término
get_categories	Obtiene todas las categorías disponibles
list_articles	Lista todos los artículos
get_article	Obtiene el contenido completo de un artículo
list_tutorials	Lista todos los tutoriales
get_tutorial	Obtiene el contenido completo de un tutorial
register_user	Registra un nuevo usuario
create_stripe_checkout	Crea una sesión de checkout de Stripe

Instalación

npm install
npm run build

Uso

Modo stdio (para Claude Desktop)

npm start
# o
node dist/index.js

Modo HTTP

npm run start:http
# o
node dist/index.js --http 3000

Variables de Entorno

Variable	Descripción	Default
SYCHEV_LAB_URL	URL base de la API	https://lab.sychev.xyz
MCP_API_KEY	API key para modo HTTP	dev-key-change-in-production

Configuración con Claude Desktop

Añade a tu configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "sychev-lab": {
      "command": "node",
      "args": ["/ruta/al/mcp-server/dist/index.js"],
      "env": {
        "SYCHEV_LAB_URL": "https://lab.sychev.xyz"
      }
    }
  }
}

Endpoints HTTP

Cuando se ejecuta en modo HTTP:

• POST /mcp/v1/tools/list - Lista herramientas disponibles
• POST /mcp/v1/tools/call - Ejecuta una herramienta

Headers requeridos:

Authorization: Bearer <MCP_API_KEY>
Content-Type: application/json

Scripts

Script	Descripción
npm run build	Compila TypeScript
npm run dev	Compila en modo watch
npm start	Inicia el servidor (stdio)
npm run start:http	Inicia el servidor HTTP
npm run inspector	Ejecuta el inspector MCP
npm run lint	Ejecuta ESLint
npm run typecheck	Verifica tipos sin emitir

Estructura del Proyecto

src/
├── index.ts    # Punto de entrada y servidor MCP
├── tools.ts    # Definiciones e implementaciones de herramientas
├── client.ts   # Cliente HTTP para la API de Sychev Lab
└── config.ts   # Configuración del servidor

Licencia

MIT