AverbePorto-MCP

🌟 关于

AverbePorto-MCP 是一个 MCP (模型上下文协议) 服务器，它允许与 AverbePorto 平台集成，从而可以通过 AI (人工智能) 工具轻松访问身份验证和文档发送服务。

🌐 访问 Web 系统

1. 访问 https://www.averbeporto.com.br
2. 使用您的用户凭据登录
3. 在平台上，您可以：
   • 在用户注册中生成 API 凭据
   • 执行 XML 文档发送
   • 查询 ANTT 协议
   • 跟踪和管理您的货物保险批单

🤖 使用 MCP 服务器与 AI 工具

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 averbeporto-mcp，请执行以下操作：

npx -y @smithery/cli install @GHSix/averbeporto-mcp --client claude

Claude Desktop

1. 编辑文件 %APPDATA%\Claude\claude_desktop_config.json (Windows) 或 ~/Library/Application Support/Claude/claude_desktop_config.json (MacOS) 并添加以下配置：

    {
      "mcpServers": {
        "AverbePorto-MCP": {
          "command": "node",
          "args": ["/caminho/para/AverbePorto-MCP/build/index.js"]
        }
      }
    }
   

2. 启动对话时，MCP 服务器将根据配置自动启动。

Cursor, Roo Code 和其他

1. 在您的项目中创建一个类似 .cursor/mcp.json 或 .roo/mcp.json 的文件，并包含以下配置：

    {
      "mcpServers": {
        "AverbePorto-MCP": {
          "command": "node",
          "args": ["/caminho/para/AverbePorto-MCP/build/index.js"],
          "disabled": false,
          "alwaysAllow": [
            "login",
            "consultProtocol",
            "upload",
            "retrieveDocument",
            "decomposeKey"
          ]
        }
      }
    }
   

2. 启动对话时，MCP 服务器将根据配置自动启动。

Github Copilot

1. 在您的编辑器中激活 Github Copilot 后，创建文件 .vscode/mcp.json:

   {
     "inputs": [
       {
         "type": "promptString",
         "id": "averbeporto-user",
         "description": "AverbePorto API 用户名"
       },
       {
         "type": "promptString",
         "id": "averbeporto-pass",
         "description": "AverbePorto API 密码",
         "password": true
       }
     ],
     "servers": {
       "AverbePorto-MCP": {
         "command": "node",
         "args": ["/caminho/para/AverbePorto-MCP/build/index.js"],
         "env": {
           "AVERBEPORTO_USER": "${input:averbeporto-user}",
           "AVERBEPORTO_PASS": "${input:averbeporto-pass}"
         }
       }
     }
   }
   

2. VS Code 将在首次执行时请求您的凭据，并安全地存储它们。
3. Copilot 将识别 MCP 命令，并为以下操作提供上下文相关的建议：
   • API 身份验证
   • XML 文档上传
   • ANTT 协议查询
4. 凭据将自动注入到 API 调用中。

📚 可供 AI 使用的工具

AverbePorto-MCP 提供以下工具：

• login: 平台身份验证

  • 参数: user, pass
  • 返回: sessionId

• upload: 文档发送

  • 参数: sessionId, filePath, recipient (可选), version (可选)
  • 返回: uploadId

• consultProtocol: 通过密钥或反之查询协议

  • 参数: sessionId, keys, protocols, outputFormat, download, delimiter
  • 输出格式: json, xml, csv

• retrieveDocument: 查询已发送的文档

  • 参数:
    • sessionId: 登录时获取的会话 ID。
    • modDoc: 文档类型 (例如, DI, MDF-e, CT-e, NF-e, Minuta CT-e)。
    • dtStart 和 dtLimit: 开始和结束日期，格式为 YYYY-MM-DD。
    • dtType: 日期类型 (Update, Emission, Send)，默认为 Send。
    • 可选过滤器: numDoc, emit, rem, exped, receb, dest, toma, importador, representante, prot, taxId。
    • 分页: page, start, limit。
    • 其他: relation, modal, valid。

• decomposeKey: 分解密钥以进行分析

  • 参数:
    • key: 用于 NF-e、CT-e 或 MDF-e 的 44 位访问密钥。

🔒 安全

• 使用在用户注册模块中生成的 API 凭据
• 确保您的凭据安全
• 不要分享您的 sessionId
• 始终使用安全连接
• 保持 MCP 服务器更新