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"]
       }
     }
   }

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

   /mcp comexstat

开发

# Executar em modo de desenvolvimento
npm run dev

# Executar testes
npm test

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

许可证

麻省理工学院