关键词

燃油站管理销售自动化库存查询财务集成API桥接

项目简介

WebPosto MCP Server是一个基于Model Context Protocol的完整服务器实现，专门用于与巴西Quality Automação公司的WebPosto燃油站管理系统进行集成。该服务器将WebPosto API的所有功能暴露为MCP工具，允许AI助手直接与燃油站管理系统进行交互，实现自动化查询和操作。

主要功能

  • 完整的API覆盖: 自动生成144个MCP工具，覆盖WebPosto系统的100%可用API端点
  • 多种部署方式: 支持Docker容器化部署、WSL/Linux原生运行、Windows PowerShell运行
  • 云原生支持: 提供AWS Serverless部署模板，可部署为Lambda函数
  • 模块化架构: 采用配置、API客户端和工具分离的设计，便于维护和扩展
  • 生产就绪: 遵循安全最佳实践，使用非root用户运行容器
  • 多传输协议: 支持Stdio、SSE、WebSocket等MCP标准传输协议

安装步骤

方法1: Docker部署（推荐）

git clone https://github.com/BrusCode/webposto-mcp-server.git
cd webposto-mcp-server
cp .env.example .env
# 编辑.env文件，设置WEBPOSTO_API_KEY
docker-compose up -d

方法2: WSL/Linux环境

git clone https://github.com/BrusCode/webposto-mcp-server.git
cd webposto-mcp-server
cp .env.example .env
nano .env  # 设置API密钥
chmod +x scripts/start_server.sh
./scripts/start_server.sh

方法3: Windows PowerShell

git clone https://github.com/BrusCode/webposto-mcp-server.git
cd webposto-mcp-server
Copy-Item .env.example .env
notepad .env  # 设置API密钥
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
.\scripts\start_server.ps1

服务器配置

MCP客户端（如Claude Desktop）需要配置以下信息来连接服务器：

配置参数说明：

  • 'command': 启动服务器的命令，如"python"或"docker"
  • 'args': 启动参数，如["-m", "src.server"]
  • 'cwd': 服务器代码所在目录
  • 'env': 环境变量，必须设置WEBPOSTO_API_KEY

示例配置：

{
  "mcpServers": {
    "webposto": {
      "command": "python",
      "args": ["-m", "src.server"],
  "cwd": "/path/to/webposto-mcp-server",
  "env": {
    "WEBPOSTO_API_KEY": "您的API密钥"
  }
}

基本使用方法

安装配置完成后，AI助手即可通过MCP协议调用各种工具：

  • 查询销售数据: 'consultar_venda(data_inicial="2025-12-18", data_final="2025-12-18")}

常用工具示例

  • 'consultar_venda_resumo': 查询销售汇总
  • 'consultar_abastecimento': 查询加油记录
  • 'consultar_estoque_periodo': 查询库存状况
  • 'consultar_cliente': 查询客户信息
  • 'incluir_produto': 新增产品
  • 'consultar_titulo_receber': 查询应收账款

服务器支持日期范围查询、状态筛选、分页控制等参数，满足各种业务场景需求。

信息

分类

商业系统

访问项目