Supplier List MCP

mcp-supplier-list

Servidor MCP para um diretório de fornecedores que não apodrece: contatos, condições de pagamento, prazos de entrega e carimbos de revisão. Um diretório de fornecedores que não apodrece: contatos, condições, prazos de entrega e quando cada registro foi revisado por último.

Funciona com Claude Desktop, Claude Code, Cursor e qualquer cliente Model Context Protocol. Roda na sua própria máquina ou hospedado, sem instalação.

Página do produto: https://mcp.zovo.one/s/supplier-list — o que faz, as ferramentas que expõe e um endpoint de token ao vivo.

Instalação

Hospedado, nada para instalar. Obtenha um token em https://mcp.zovo.one/mcp/connect (a página de conexão) ou https://mcp.zovo.one/mcp/token (o mesmo token em JSON); um token anônimo gratuito é emitido na hora e uma chave Pro funciona da mesma forma. Em seguida, aponte um cliente MCP para https://mcp.zovo.one/mcp/supplier-list via streamable-http e envie o token como Authorization: Bearer <token>.

Se o seu cliente não puder definir cabeçalhos, coloque o token no caminho: https://mcp.zovo.one/mcp/supplier-list/t/<token>. Ambas as formas funcionam. A URL simples sem token responde 401 em tools/call, então o token não é opcional.

Claude Desktop, um clique. Baixe supplier-list.mcpb da última versão e clique duas vezes.

A partir do código-fonte. O espelho é autocontido: cada dependência @theluckystrike/* é incluída, então um clone novo compila sem configuração extra.

git clone https://github.com/theluckystrike/mcp-supplier-list.git
cd mcp-supplier-list
npm install && npm run build

Em seguida, aponte seu cliente para o ponto de entrada compilado:

{
  "mcpServers": {
    "supplier-list": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-supplier-list/dist/index.js"]
    }
  }
}

@theluckystrike/mcp-supplier-list ainda não está publicado no npm, então um comando npx -y @theluckystrike/mcp-supplier-list falhará. Os três caminhos acima são os que funcionam e cada um é testado pela CI.

Espelho somente leitura de mcp-servers/servers/supplier-list. Veja MIRROR.md.

No Registro Oficial MCP (io.github.theluckystrike/supplier-list). Este é o servidor de lista de fornecedores mcp: um diretório de fornecedores dentro do seu cliente MCP que não apodrece como a planilha. Adicione cada fornecedor uma vez, o que eles fornecem, quem contatar e como, as condições de pagamento, o prazo de entrega em dias e notas, e cada registro carrega a data da última revisão, então "quais desses registros ficaram desatualizados?" é uma pergunta que o diretório responde em vez de uma tarefa que você esquece. Peça um fornecedor pelo nome, liste o diretório por categoria e exporte tudo para CSV ou Markdown quando outra pessoa precisar. Tudo permanece nesta máquina; não há conta nem chamada de rede.

Construído por theluckystrike.

A publicação no npm para @theluckystrike/mcp-supplier-list está pendente, então npx -y @theluckystrike/mcp-supplier-list retorna 404 hoje. Até lá, clone+compilação é o caminho que funciona.

Por que não uma planilha

Uma planilha de fornecedores apodrece porque nada nela indica que está desatualizada: o número de telefone mudou há oito meses e você descobre quando o pedido volta. Uma lista de fornecedores mcp vive onde as conversas de compras já acontecem, e o carimbo de revisão em cada registro transforma "isso ainda é verdade?" em um relatório em vez de um teste de memória.

Instalação

Claude Desktop

macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "supplier-list": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-supplier-list"]
    }
  }
}

Claude Code

claude mcp add supplier-list -- npx -y @theluckystrike/mcp-supplier-list

Cursor

~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto), mesma entrada do Claude Desktop.

Ferramentas

ferramenta	o que faz
supplier_add	Adicionar um fornecedor: nome, categoria, campos de contato, condições de pagamento, prazo de entrega em dias, notas. Retorna SUP-YYYY-NNNN
supplier_list	Listar o diretório de A a Z com contato, condições, prazo de entrega e idade da revisão; filtrar por categoria e texto livre
supplier_get	Ler um registro de fornecedor completo pelo número SUP ou nome
supplier_update	Alterar qualquer campo de um registro; apenas o que você passar é alterado
supplier_remove	Remover um fornecedor, retornando o registro como estava. O número nunca é reemitido
supplier_mark_reviewed	Carimbar um registro como revisado em uma data, hoje por padrão
supplier_due_review	O relatório de revisão pendente: registros não revisados em N dias (padrão 90), mais atrasados primeiro. Pro
supplier_export	Exportar o diretório como CSV (gratuito) ou tabela Markdown (Pro), com filtros opcionais de categoria e texto
license_status / license_activate	Gratuito ou Pro, e a chave

Gratuito vs Pro

	Gratuito	Pro
Fornecedores no diretório	10	Ilimitado
Adicionar, listar, obter, atualizar, remover	Sim	Sim
Carimbos de revisão	Sim	Sim
Exportação CSV	Sim	Sim
Exportação Markdown	Não	Sim
Relatório de revisão pendente	Não	Sim

O diretório em si nunca é medido. Dez fornecedores é uma lista de trabalho real para um freelancer, e ler, alterar, pesquisar e exportar para CSV os fornecedores que você tem permanece gratuito para sempre. O que o Pro eleva é quantos fornecedores o diretório comporta, exportação Markdown e o relatório de revisão pendente que mantém um diretório maior honesto.

Obtenha Pro: https://mcp.zovo.one/buy/supplier-list, $19 pagamento único para este servidor, ou $39 para o pacote.

Privacidade

Todos os dados permanecem locais, em ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/supplier-list/. Dois arquivos: suppliers.json, counter.json. Nada é enviado a lugar algum, não há conta, nenhuma chave de API e nenhuma chamada de rede neste servidor. Chaves de licença são verificadas offline.

Construído por theluckystrike. https://github.com/theluckystrike

Use estes documentos como um servidor MCP

Qualquer cliente MCP (Claude, Cursor, Windsurf, VS Code) pode ler a documentação deste repositório diretamente via GitMCP — sem instalação:

• URL MCP de Documentos: https://gitmcp.io/theluckystrike/mcp-supplier-list