AI导哈

加油站管理系统集成服务

该服务是一个MCP服务器，用于与WEBPOSTO加油站管理系统集成，提供加油站的财务、销售、库存和运营状态查询功能。

  • by LeoGarcia109
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 leogarcia109/webposto-mcp

使用说明

Webposto MCP Server

Servidor MCP (Model Context Protocol) para integração com WEBPOSTO - Sistema de Gestão de Postos de Combustível.

Descrição

Este servidor MCP permite que assistentes de IA interajam com o sistema WEBPOSTO para consultar informações sobre:

  • Caixas e fechamentos
  • Abastecimentos e vendas de combustível
  • Estoque de produtos e tanques
  • Despesas financeiras
  • Movimentação de combustível (LMC)
  • Status operacional do posto

Instalação

Pré-requisitos

  • Python 3.8+
  • uv (Python package manager)

Configuração

  1. Clone o repositório:
git clone https://github.com/leopn08/webposto-mcp.git
cd webposto-mcp
  1. Instale as dependências:
uv pip install -r requirements.txt
  1. Configure as variáveis de ambiente:
cp .env.example .env
# Edite o arquivo .env e adicione sua API key do WEBPOSTO
  1. Configure o servidor no Claude Desktop ou Claude Code:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "webposto-mcp": {
      "command": "/path/to/webposto-mcp/start_webposto.sh"
    }
  }
}

Claude Code (~/.claude/mcp_servers.json):

{
  "mcpServers": {
    "webposto-mcp": {
      "command": "/path/to/webposto-mcp/start_webposto.sh"
    }
  }
}

Funcionalidades

Consultas Disponíveis

  • webposto_consultar_caixas: Consulta informações de caixas no período
  • webposto_consultar_abastecimentos: Consulta abastecimentos realizados
  • webposto_consultar_vendas_resumo: Resumo de vendas por período
  • webposto_consultar_vendas_combustivel: Vendas específicas de combustível
  • webposto_consultar_vendas_itens: Vendas detalhadas por item
  • webposto_consultar_estoque_produtos: Estoque atual de produtos
  • webposto_consultar_estoque_periodo: Movimentação de estoque no período
  • webposto_consultar_despesas_financeiro: Despesas financeiras da empresa
  • webposto_consultar_tanques: Informações dos tanques de combustível
  • webposto_consultar_lmc: Livro de Movimentação de Combustível
  • webposto_status_operacional: Status operacional do posto

Configuração da API

O servidor está configurado para usar a API WEBPOSTO em:

  • URL: https://web.qualityautomacao.com.br/INTEGRACAO
  • Autenticação via header X-API-Key

Licença

MIT

Autor

Leandro Garcia

相关 MCP