itemit-mcp

Un servidor MCP para seguimiento de activos que se conecta a la API de gestión de activos de itemit.

GitHub

Documentación

itemit-mcp

itemit-mcp es un servidor MCP para el seguimiento de activos, que proporciona un puente entre la API de gestión de activos de itemit y el ecosistema del Protocolo de Contexto de Modelos (MCP).

Desarrollado y mantenido por el equipo de uminai MCP.

Tabla de Contenidos

Descripción General

itemit-mcp expone un conjunto de herramientas para interactuar con la plataforma de gestión de activos itemit a través del protocolo MCP. Permite buscar, crear y gestionar activos y ubicaciones de forma programática, facilitando la integración de itemit con otros sistemas compatibles con MCP. Las siguientes herramientas están disponibles:

  • Obtener lista de artículos
  • Obtener artículo por búsqueda de nombre
  • Crear artículo
  • Búsqueda de ubicación (con lista de artículos incluida)

Requisitos Previos

  • Node.js (v16+ recomendado)
  • Acceso a una cuenta de itemit (para obtener credenciales de API)
  • Cliente MCP (consulta uminai MCP para más información)

Obtención de Credenciales de la API de itemit

Para usar este servidor MCP, necesitas credenciales de API de itemit:

  • ITEMIT_API_KEY
  • ITEMIT_USER_ID
  • ITEMIT_USER_TOKEN
  • ITEMIT_WORKSPACE_ID

Puedes obtenerlas registrándote o iniciando sesión en itemit y siguiendo su documentación de API o contactando con su soporte.

Instalación y Compilación

Clona este repositorio e instala las dependencias:

npm install

Compila el proyecto:

npm run build

Configuración del Cliente MCP

Añade lo siguiente a la configuración de tu Cliente MCP (por ejemplo, cline_mcp_settings.json):

{
  "mcpServers": {
    "itemit-mcp": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": [
        "/Users/<user>/Documents/itemit-mcp/build/index.js"
      ],
      "env": {
        "ITEMIT_API_KEY": "<YOUR_API_KEY>",
        "ITEMIT_USER_ID": "<YOUR_USER_ID>",
        "ITEMIT_USER_TOKEN": "<YOUR_USER_TOKEN>",
        "ITEMIT_WORKSPACE_ID": "<YOUR_WORKSPACE_ID>"
      }
    }
  }
}

Reemplaza los valores de los marcadores de posición con tus credenciales reales de itemit.

Variables de Entorno

  • ITEMIT_API_KEY: Tu clave de API de itemit
  • ITEMIT_USER_ID: Tu ID de usuario de itemit
  • ITEMIT_USER_TOKEN: Tu token de usuario de itemit
  • ITEMIT_WORKSPACE_ID: Tu ID de espacio de trabajo de itemit

Estas pueden configurarse en tu entorno o en un archivo .env.

Herramientas MCP Disponibles

1. get-location-by-name

  • Descripción: Obtener ubicaciones por nombre en itemit.
  • Parámetros:
    • name (cadena, obligatorio): Nombre de la ubicación a buscar
    • limit (entero, opcional): Número de ubicaciones a recuperar (por defecto 25, máximo 100)
    • skip (entero, opcional): Número de ubicaciones a omitir (por defecto 0)
  • Ejemplo: 
    {
  "name": "Warehouse"
}

2. search-item-by-name

  • Descripción: Buscar artículos por nombre en itemit.
  • Parámetros:
    • name (cadena, obligatorio): Nombre del artículo a buscar
    • size (entero, opcional): Número de artículos a recuperar (por defecto 15, máximo 100)
    • page (entero, opcional): Número de página (por defecto 1)
  • Ejemplo: 
    {
  "name": "Laptop"
}

3. create-item

  • Descripción: Crear un artículo en itemit.
  • Parámetros:
    • name (cadena, obligatorio): Nombre del artículo
    • description (cadena, obligatorio): Descripción del artículo
    • serial (cadena, obligatorio): Número de serie del artículo
  • Ejemplo: 
    {
  "name": "Projector",
  "description": "Epson HD Projector",
  "serial": "SN123456"
}

4. get-reminders

  • Descripción: Obtener recordatorios de itemit.
  • Parámetros: Ninguno

5. get-items

  • Descripción: Obtener artículos de itemit.
  • Parámetros:
    • size (entero, opcional): Número de artículos a recuperar (por defecto 15, máximo 100)
  • Ejemplo: 
    {
  "size": 10
}

Ejemplo de Uso

Usa tu Cliente MCP para invocar estas herramientas. Por ejemplo, para buscar un artículo:

{
  "tool": "search-item-by-name",
  "arguments": {
    "name": "Laptop"
  }
}

Formato de Respuesta

Todas las respuestas se devuelven como texto estructurado o JSON, coincidiendo con el modelo de datos de la API de itemit. Por ejemplo, una búsqueda exitosa podría devolver:

{
  "content": [
    {
      "type": "text",
      "text": "Search results for \"Laptop\" (size=15):\n1. Dell XPS 13 (ID: 1234)\n2. MacBook Pro (ID: 5678)\n..."
    }
  ]
}

Créditos y Recursos Adicionales