Skip to main content
Glama
mcp-comexstat

mcp-comexstat

by luizzzvictor

Comexstat API용 MCP 서버

이 프로젝트는 Comexstat API를 위한 MCP(Model Context Protocol) 서버를 구현하여 Claude와 같은 AI 모델이 브라질의 해외 무역 데이터와 직접 상호 작용할 수 있도록 합니다.

개요

MCP Comexstat 서버는 다음을 포함하여 브라질 수출 및 수입 통계를 쿼리하는 도구를 제공합니다.

  • 일반 수출입 데이터

  • 지자체별 데이터

  • 역사적 자료(1989-1996)

  • 코드와 설명이 있는 보조 표

Related MCP server: br-eli-mcp

특징

  • @modelcontextprotocol/sdk를 사용하여 구현됨

  • TypeScript로 타이핑하기

  • Zod를 사용한 데이터 검증

  • stdin/stdout(MCP 표준)을 통한 통신 지원

  • 강력한 API 오류 처리 및 응답

설치

지엑스피1

빠른 사용

# Execute o servidor MCP
npm start

사용 가능한 도구

MCP 서버는 다음과 같은 도구를 제공합니다.

일반 데이터

  • getLastUpdate() - 데이터가 마지막으로 업데이트된 날짜를 가져옵니다.

  • getAvailableYears() - 쿼리에 사용 가능한 연도를 나열합니다.

  • getAvailableFilters() - 사용 가능한 필터를 나열합니다.

  • getFilterValues(filter, language?) - 특정 필터에 대한 값을 가져옵니다.

  • getAvailableFields() - 세부 정보에 사용할 수 있는 필드를 나열합니다.

  • getAvailableMetrics() - 사용 가능한 메트릭을 나열합니다.

  • queryData(options) - 다음 매개변수를 사용하여 자세한 쿼리를 수행합니다.

    • flow : "내보내기" | "수입"

    • period : { 시작: "YYYY-MM", 종료: "YYYY-MM" }

    • monthDetail : 부울

    • 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?) - 조화 시스템(HS)

  • 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와의 통합

Claude Desktop과 함께 MCP 서버를 사용하려면:

  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

특허

MIT

Available Tools

20 tools
getAuxiliaryTableD

Inputs: table (required), page, pageSize, search.

getAvailableFieldsD

Inputs: no named parameters.

getAvailableFiltersD

Inputs: no named parameters.

getAvailableMetricsD

Inputs: no named parameters.

getAvailableYearsD

Inputs: no named parameters.

getCitiesD

Inputs: no named parameters.

getCityDetailsD

Inputs: cityId (required).

getCountriesD

Inputs: search.

getCountryDetailsD

Inputs: countryId (required).

getEconomicBlocksD

Inputs: add, language, search.

getFilterValuesD

Inputs: filter (required), language.

getHarmonizedSystemD

Inputs: add, language, page, perPage.

getLastUpdateD

Inputs: no named parameters.

getNBMD

Inputs: add, language, page, perPage, +1 more.

getNBMDetailsD

Inputs: coNbm (required).

getStateDetailsD

Inputs: ufId (required).

getStatesD

Inputs: no named parameters.

queryDataD

Inputs: details (required), flow (required), metrics (required), monthDetail (required), +3 more.

queryHistoricalDataD

Inputs: details (required), flow (required), metrics (required), period (required), +3 more.

queryMunicipalitiesDataD

Inputs: details (required), flow (required), metrics (required), period (required), +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.9/5.0

    Scored across 20 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes targeting different data entities (countries, states, cities, NBM, etc.) or metadata (available fields, filters, metrics). However, some pairs like getCities/getMunicipalitiesData and getNBM/getNBMDetails have potential overlap that could cause confusion without descriptions to clarify their boundaries.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with 'get' or 'query' prefixes, using camelCase uniformly throughout. The naming is highly predictable and readable, with clear conventions for different types of operations (get for metadata/entities, query for data retrieval).

    Tool Count3/5

    With 20 tools, this is borderline heavy for a trade statistics server. While the domain appears broad (covering countries, states, cities, NBM codes, auxiliary tables, etc.), the count feels somewhat inflated with multiple similar metadata tools (getAvailableFields/Filters/Metrics/Years) that might be consolidated.

    Completeness4/5

    The tool set appears to provide comprehensive coverage for trade data exploration and retrieval, including metadata discovery, entity lookups, and data querying across different dimensions (current, historical, municipal). Minor gaps might exist in data modification capabilities, but for a read-only statistical service, the surface seems reasonably complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      MCP Server do SEI Pro para o SEI (Sistema Eletrônico de Informações) via API REST mod-wssei v2 + scraper do frontend web (modo híbrido).
      100
      21
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for the Brazilian Chamber of Deputies open-data API, enabling search and retrieval of federal legislative bills and their status.
      15
      82 PyPI
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the Omie API to list products, consult clients, and create budgets
      MIT