AverbePorto-MCP

Name: AverbePorto-MCP
Author: GHSix

本地服务

github.com/GHSix金融数据080 周前更新

代码仓库

关于 AverbePorto-MCP

AverbePorto-MCP 将 AI 工具连接到 AverbePorto 平台，用于身份验证和货运保险单据处理。其工具涵盖 XML 上传、协议查询、文档检索和密钥分解。

主要功能

01AverbePorto 身份验证
02上传文档
03查询 ANTT 协议
04检索已提交文档
05分解文档密钥

适用场景

01通过 AI 工具登录 AverbePorto
02上传 XML 文档
03查询协议或已提交文档
04分析 NF-e、CT-e 或 MDF-e 密钥

MCP 相关

该 MCP 服务将 AverbePorto 的身份验证和文档操作作为工具提供给兼容的 AI 客户端。可用工具包括 `login`、`upload`、`consultProtocol`、`retrieveDocument` 和 `decomposeKey`。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "AverbePorto-MCP": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@smithery/clistdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

AverbePorto-MCP

🌟 关于

AverbePorto-MCP 是一个 MCP（Model Context Protocol）服务，可与 AverbePorto 平台集成，方便通过 AI（人工智能）工具访问身份验证和文档发送服务。

🌐 访问 Web 系统

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

🤖 使用 MCP 服务和 AI 工具

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 averbeporto-mcp：

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

Claude Desktop

编辑文件 %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"]
     }
   }
 }
```
开始对话时，MCP 服务将根据配置自动启动。

Cursor、Roo Code 等

在项目中创建 .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"
       ]
     }
   }
 }

开始对话时，MCP 服务将根据配置自动启动。

Github Copilot

在编辑器中启用 Github Copilot 后，创建文件 .vscode/mcp.json：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "averbeporto-user",
      "description": "AverbePorto API Username"
    },
    {
      "type": "promptString",
      "id": "averbeporto-pass",
      "description": "AverbePorto API Password",
      "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}"
      }
    }
  }
}

VS Code 会在首次运行时提示您输入凭据，并安全地存储这些凭据。
Copilot 将识别 MCP 命令，并根据上下文提供以下建议：
- API 身份验证
- 上传 XML 文档
- 查询 ANTT 协议
凭据将自动注入 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 位访问密钥。