itemit-mcp

Um servidor MCP para rastreamento de ativos que se conecta à API de gerenciamento de ativos do itemit.

GitHub

Documentação

itemit-mcp

itemit-mcp é um servidor MCP para rastreamento de ativos, fornecendo uma ponte entre a API de gerenciamento de ativos do itemit e o ecossistema do Model Context Protocol (MCP).

Construído e mantido pela equipe uminai MCP.

Sumário

Visão Geral

O itemit-mcp expõe um conjunto de ferramentas para interagir com a plataforma de gerenciamento de ativos itemit por meio do protocolo MCP. Ele permite pesquisar, criar e gerenciar ativos e locais programaticamente, facilitando a integração do itemit com outros sistemas habilitados para MCP. As seguintes ferramentas estão disponíveis:

  • Obter lista de itens
  • Obter item por busca de nome
  • Criar item
  • Busca de localização (com lista de itens nela)

Pré-requisitos

  • Node.js (v16+ recomendado)
  • Acesso a uma conta itemit (para obter credenciais da API)
  • Cliente MCP (veja uminai MCP para mais informações)

Obtendo Credenciais da API do itemit

Para usar este servidor MCP, você precisa de credenciais de API do itemit:

  • ITEMIT_API_KEY
  • ITEMIT_USER_ID
  • ITEMIT_USER_TOKEN
  • ITEMIT_WORKSPACE_ID

Você pode obtê-las criando uma conta ou fazendo login em itemit e seguindo a documentação da API ou entrando em contato com o suporte.

Instalação e Build

Clone este repositório e instale as dependências:

npm install

Compile o projeto:

npm run build

Configuração do Cliente MCP

Adicione o seguinte à configuração do seu Cliente MCP (por exemplo, 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>"
      }
    }
  }
}

Substitua os valores de exemplo pelas suas credenciais reais do itemit.

Variáveis de Ambiente

  • ITEMIT_API_KEY: Sua chave de API do itemit
  • ITEMIT_USER_ID: Seu ID de usuário do itemit
  • ITEMIT_USER_TOKEN: Seu token de usuário do itemit
  • ITEMIT_WORKSPACE_ID: Seu ID de workspace do itemit

Eles podem ser definidos no seu ambiente ou em um arquivo .env.

Ferramentas MCP Disponíveis

1. get-location-by-name

  • Descrição: Obter locais por nome no itemit.
  • Parâmetros:
    • name (string, obrigatório): Nome do local a ser pesquisado
    • limit (inteiro, opcional): Número de locais a recuperar (padrão 25, máximo 100)
    • skip (inteiro, opcional): Número de locais a pular (padrão 0)
  • Exemplo: 
    {
  "name": "Warehouse"
}

2. search-item-by-name

  • Descrição: Pesquisar itens por nome no itemit.
  • Parâmetros:
    • name (string, obrigatório): Nome do item a ser pesquisado
    • size (inteiro, opcional): Número de itens a recuperar (padrão 15, máximo 100)
    • page (inteiro, opcional): Número da página (padrão 1)
  • Exemplo: 
    {
  "name": "Laptop"
}

3. create-item

  • Descrição: Criar um item no itemit.
  • Parâmetros:
    • name (string, obrigatório): Nome do item
    • description (string, obrigatório): Descrição do item
    • serial (string, obrigatório): Número de série do item
  • Exemplo: 
    {
  "name": "Projector",
  "description": "Epson HD Projector",
  "serial": "SN123456"
}

4. get-reminders

  • Descrição: Obter lembretes do itemit.
  • Parâmetros: Nenhum

5. get-items

  • Descrição: Obter itens do itemit.
  • Parâmetros:
    • size (inteiro, opcional): Número de itens a recuperar (padrão 15, máximo 100)
  • Exemplo: 
    {
  "size": 10
}

Exemplo de Uso

Use seu Cliente MCP para invocar essas ferramentas. Por exemplo, para pesquisar um item:

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

Formato de Resposta

Todas as respostas são retornadas como texto estruturado ou JSON, correspondendo ao modelo de dados da API do itemit. Por exemplo, uma pesquisa bem-sucedida pode retornar:

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

Créditos e Recursos Adicionais