Servidor MCP de Shiplogic

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una integración fluida con la API de envío de Shiplogic. Desarrollado con el SDK de MCP y TypeScript para garantizar la seguridad de tipos y una mejor experiencia para el desarrollador.

Manifestación

# Example conversation with Claude:
User: "Get shipping rates from Cape Town to Johannesburg for a 2.5kg parcel"
Claude: "I'll check shipping rates for you..."

[Using tool: get_shipping_rates]
Result: Economy service - R95 (2-3 days delivery)

User: "Book the economy service"
Claude: "Creating shipment..."

[Using tool: create_shipment]
Result: Shipment created! Tracking: QR4FVL

Características

🚚 Obtener tarifas de envío - Calcular los costos de envío entre direcciones
📦 Crear envíos - Reserva envíos con seguimiento automático
🔍 Seguimiento de paquetes : seguimiento de envíos en tiempo real
❌ Cancelar envíos - Cancelar reservas cuando sea necesario
➕ Servicios opcionales - Accede a tarifas adicionales para servicios especiales
📚 Gestión de la libreta de direcciones : almacene y administre las direcciones utilizadas con frecuencia

Instalación

Prerrequisitos

Node.js 18+
npm o hilo
Clave API de Shiplogic (obtenga una en shiplogic.com )

Inicio rápido

Clonar e instalar:

git clone https://github.com/jlwainwright/shiplogic-mcp.git
cd shiplogic-mcp
npm install

Configurar el entorno:

cp .env.example .env
# Edit .env and add your Shiplogic API key

Construir el servidor:

npm run build

Uso

Con Claude Desktop

Añade esto a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "shiplogic": {
      "command": "node",
      "args": ["/absolute/path/to/shiplogic-mcp/dist/index.js"],
      "env": {
        "SHIPLOGIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

Con MCP Inspector

Pruebe el servidor usando el Inspector MCP:

npm run inspect

Autónomo

Ejecute el servidor directamente:

npm run dev

Herramientas disponibles

`get_shipping_rates`

Calcular tarifas de envío entre dos direcciones.

{
  collection_address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business"
  },
  delivery_address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business"
  },
  parcels: [{
    length: number,    // cm
    width: number,     // cm
    height: number,    // cm
    weight: number,    // kg
    description?: string
  }],
  declared_value?: number
}

`create_shipment`

Crear un nuevo envío con seguimiento.

{
  service_level_code: string,  // e.g., "ECO"
  collection_address: { /* same as above */ },
  delivery_address: { /* same as above */ },
  parcels: [{ /* same as above */ }],
  collection_contact: {
    name: string,
    mobile_number?: string,
    email?: string
  },
  delivery_contact: {
    name: string,
    mobile_number?: string,
    email?: string
  },
  customer_reference?: string,
  mute_notifications?: boolean
}

`track_shipment`

Rastrear un envío por número de referencia.

{
  tracking_number: string
}

`cancel_shipment`

Cancelar un envío existente.

{
  tracking_reference: string
}

`get_opt_in_rates`

Obtenga tarifas de servicios complementarios opcionales.

{
  collection_address: { /* address object */ },
  delivery_address: { /* address object */ }
}

`add_address_to_book`

Agregar una dirección a la libreta de direcciones de la cuenta.

{
  account_id: number,
  address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business",
    company?: string
  },
  name?: string,            // Name for this address entry
  type?: "collection" | "delivery"  // Address type
}

`get_address_book`

Recuperar direcciones de la libreta de direcciones de la cuenta.

{
  account_id: number,
  type?: "collection" | "delivery"  // Optional filter by type
}

`remove_address_from_book`

Eliminar una dirección de la libreta de direcciones de la cuenta.

{
  account_id: number,
  address_id: number
}

Configuración

Variables de entorno:

Variable	Descripción	Requerido	Por defecto
`SHIPLOGIC_API_KEY`	Su clave API de Shiplogic	Sí	-
`SHIPLOGIC_API_URL`	URL base de la API	No	`https://api.shiplogic.com`

Desarrollo

Estructura del proyecto

shiplogic-mcp-official/
├── src/
│   └── index.ts        # Main server implementation
├── dist/               # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

Guiones

npm run build - Compilar TypeScript
npm run dev - Construir y ejecutar
npm run inspect - Ejecutar con MCP Inspector

Pruebas

# Run with MCP Inspector
npm run inspect

# In another terminal, test the tools
curl -X POST http://localhost:3000/tools/list

Referencia de API

Este servidor se integra con la API de Shiplogic v2. Para obtener documentación detallada de la API, consulte:

Licencia

Licencia MIT - ver archivo LICENCIA

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirmar cambios ( git commit -m 'Add amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Apoyo

🐛 Problemas: Problemas de GitHub
📧 Correo electrónico: tu.correo@ejemplo.com
📚 Documentos: Wiki
☕ Apoya mi trabajo: Invítame a un café

Si este proyecto te resulta útil, considera apoyar mi trabajo. Tu apoyo me ayuda a dedicar más tiempo al desarrollo de código abierto y a crear mejores herramientas para la comunidad.

Expresiones de gratitud

Creado con el SDK del protocolo de contexto de modelo
Desarrollado por Shiplogic API

Hecho con ❤️ por Jacques Wainwright

Shiplogic MCP Server

Integrations