AI导哈

外贸数据查询服务器

MCP服务器为巴西外贸数据API提供接口，允许AI模型直接查询巴西进出口统计数据。

  • by luizzzvictor
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 luizzzvictor/mcp-comexstat

使用说明

MCP服务器段落API Comexstat

该项目为Comexstat API实现了一个MCP（模型上下文协议）服务器，允许像Claude这样的人工智能模型直接与巴西的外贸数据交互。

概览

Comexstat MCP 服务器提供了查询巴西进出口统计的工具，包括：

  • 一般出口和进口数据
  • 按市镇分列的数据
  • 历史数据（1989-1996）
  • 附带代码和描述的辅助表格

特征

  • 使用实现 @模型上下文协议/sdk
  • 用 TypeScript 打字
  • 使用 Zod 验证数据
  • 支持 stdin/stdout 通信（MCP 标准）
  • 强大的错误处理和 API 响应

安装

通过Smithery安装

通过以下方式自动安装Comexstat Data Server for Claude Desktop 史密瑟里:

npx -y @smithery/cli install @luizzzvictor/mcp-comexstat --client claude

手动安装

# Clone o repositório
git clone https://github.com/luizzzvictor/mcp-comexstat-easy.git
cd mcp-comexstat-easy

# Instale as dependências
npm install

# Compile o código TypeScript
npm run build

快速使用

# Execute o servidor MCP
npm start

可用工具

MCP 服务器提供以下工具：

一般数据

  • getLastUpdate() - 获取数据最后更新的日期
  • getAvailableYears() - 可供查询的年份列表
  • getAvailableFilters() 列出可用的过滤器
  • getFilterValues(filter, language?) 获取特定过滤器的值
  • getAvailableFields() - 列出可用于详细信息的字段
  • getAvailableMetrics() 列出可用的指标
  • queryData(options) - 使用以下参数进行详细查询：
    • flow：“导出”|“导入”
    • period：{从：“YYYY-MM”到：“YYYY-MM”}
    • monthDetail：boolean
    • filters：滤波器阵列（操作）
    • details： 用于详细信息的字段数组
    • metrics指标数组
    • language: 字符串（ 可选， 默认 : “pt”）

按市镇分列的数据

  • queryMunicipalitiesData(options) - 查询以市镇为重点的数据

历史数据

  • queryHistoricalData(options) 查询历史数据（1989-1996）

辅助表格

  • getStates() 巴西国家列表
  • getStateDetails(ufId) 特定状态的详细信息
  • getCities() 城市名单
  • getCityDetails(cityId) 特定城市的详细信息
  • getCountries(search?) -列出国家
  • getCountryDetails(countryId) 特定国家的详细信息
  • getEconomicBlocks(options?) 经济区块列表
  • getHarmonizedSystem(options?) -和谐系统（上海）
  • getNBM(options?) 巴西商品名称
  • getNBMDetails(coNbm) 特定NBM代码的详细信息

使用范例

// Consultar exportações para os EUA em 2023
const result = await queryData({
  flow: "export",
  period: { from: "2023-01", to: "2023-12" },
  monthDetail: false,
  filters: [{ filter: "country", values: [105] }],
  details: ["country", "month"],
  metrics: ["metricFOB", "metricKG"],
});

与Claude的整合

要将 MCP 服务器与 Claude Desktop 配合使用：

  1. 将配置添加到文件 claude_desktop_config.json:

    {
  "mcpServers": {
    "comexstat": {
      "command": "node",
      "args": ["/caminho/completo/para/mcp-comexstat-easy/dist/index.js"]
    }
  }
}

  2. 在 Claude Desktop 中，使用以下命令：

    /mcp comexstat

开发

# Executar em modo de desenvolvimento
npm run dev

# Executar testes
npm test

# Verificar cobertura de testes
npm test -- --coverage

许可证

麻省理工学院

相关 MCP