Comexstat API용 MCP 서버

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

개요

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

• 일반 수출입 데이터

• 지자체별 데이터

• 역사적 자료(1989-1996)

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

Related MCP server: MCP Expr Lang

특징

• @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