ThirtyBees MCP

Cliente MCP para ThirtyBees que proporciona herramientas para interactuar con la API de ThirtyBees de forma eficiente.

Características

• Consulta de categorías y productos
• Obtención de información detallada de clientes y pedidos
• Generación de URLs amigables para SEO
• Optimizado para reducir llamadas a la API

Instalación

# Instalar desde npm
npm install thirtybees-mcp

# O instalar desde GitHub
npm install aitorroma/thirtybees-mcp

Configuración

El cliente utiliza variables de entorno para la configuración:

# Configurar en el archivo .env o en el entorno
API_HOST=https://tutienda.com/api
API_KEY=TU_CLAVE_API

O puedes proporcionar estos valores directamente en cada llamada a las herramientas.

Uso como cliente MCP

Este paquete puede ser utilizado como un servidor MCP para integrarse con Claude o como una biblioteca JavaScript normal.

Uso como servidor MCP

Actualmente hay algunos problemas con el servidor MCP. Estamos trabajando para solucionarlos. Mientras tanto, puedes usar las herramientas directamente como se muestra a continuación.

Uso directo como biblioteca JavaScript

Puedes usar las herramientas directamente en tu código JavaScript/TypeScript:

// Importar las herramientas que necesites
import { ListarCategoriasTool } from 'thirtybees-mcp/dist/tools/ListarCategoriasTool.js';
import { ProductosPorCategoriaTool } from 'thirtybees-mcp/dist/tools/ProductosPorCategoriaTool.js';

// Crear instancias de las herramientas
const listarCategorias = new ListarCategoriasTool();
const productosPorCategoria = new ProductosPorCategoriaTool();

// Usar las herramientas
async function main() {
  // Listar todas las categorías
  const categorias = await listarCategorias.execute({});
  console.log(categorias);
  
  // Obtener productos de una categoría (por ejemplo, faldas - ID 16)
  const productos = await productosPorCategoria.execute({
    category_id: 16
  });
  console.log(productos);
}

main().catch(console.error);

Ejemplo completo

Hemos incluido un ejemplo completo en el directorio examples/:

# Clonar el repositorio
git clone https://github.com/aitorroma/thirtybees-mcp.git
cd thirtybees-mcp

# Instalar dependencias
npm install

# Ejecutar el ejemplo
node examples/uso-basico.js

Herramientas disponibles

Listar categorías

Obtiene todas las categorías disponibles en la tienda:

import { ListarCategoriasTool } from 'thirtybees-mcp/dist/tools/ListarCategoriasTool.js';

const listarCategorias = new ListarCategoriasTool();
const categorias = await listarCategorias.execute({});
console.log(categorias);

Obtener productos por categoría

Obtiene los productos de una categoría específica:

import { ProductosPorCategoriaTool } from 'thirtybees-mcp/dist/tools/ProductosPorCategoriaTool.js';

const productosPorCategoria = new ProductosPorCategoriaTool();
const productos = await productosPorCategoria.execute({
  category_id: 16  // ID de la categoría (por ejemplo, faldas)
});
console.log(productos);

Obtener URL limpia de un producto

Obtiene la URL amigable para SEO de un producto:

import { ObtenerUrlLimpiaTool } from 'thirtybees-mcp/dist/tools/ObtenerUrlLimpiaTool.js';

const obtenerUrlLimpia = new ObtenerUrlLimpiaTool();
const urlInfo = await obtenerUrlLimpia.execute({
  product_id: 10  // ID del producto
});
console.log(urlInfo.url_limpia);

Información de cliente

Obtiene información detallada de un cliente:

import { CustomerInfoTool } from 'thirtybees-mcp/dist/tools/CustomerInfoTool.js';

const customerInfo = new CustomerInfoTool();
const cliente = await customerInfo.execute({
  email: '[email protected]'  // Buscar cliente por email
});
console.log(cliente);

Información de pedido

Obtiene información detallada de un pedido:

import { OrderInfoTool } from 'thirtybees-mcp/dist/tools/OrderInfoTool.js';

const orderInfo = new OrderInfoTool();
const pedido = await orderInfo.execute({
  order_id: '123'  // ID del pedido
});
console.log(pedido);

Estructura del proyecto

thirtybees-mcp/
├── src/
│   ├── tools/                    # Herramientas MCP
│   │   ├── CustomerInfoTool.ts   # Información de clientes
│   │   ├── EnhancedCategoryQueryTool.ts
│   │   ├── ListarCategoriasTool.ts
│   │   ├── ObtenerUrlLimpiaTool.ts
│   │   ├── OrderInfoTool.ts      # Información de pedidos
│   │   ├── ProductInfoTool.ts    # Información de productos
│   │   └── ProductosPorCategoriaTool.ts
│   ├── apiClient.js              # Cliente API para ThirtyBees
│   └── index.ts                  # Punto de entrada del servidor
├── examples/                     # Ejemplos de uso
│   └── uso-basico.js             # Ejemplo básico de uso
├── package.json
└── tsconfig.json

Desarrollo

Para contribuir al desarrollo:

# Clonar el repositorio
git clone https://github.com/aitorroma/thirtybees-mcp.git
cd thirtybees-mcp

# Instalar dependencias
npm install

# Compilar el proyecto
npm run build

# Ejecutar en modo desarrollo
npm run watch

Publicación en npm

# Actualizar la versión
npm version patch|minor|major

# Publicar en npm
npm publish

Licencia

MIT

Autor

Aitor Roma