query-ptax-bcb

MCP(Model Context Protocol) 서버로, Banco Central do Brasil(BCB)의 공개 데이터 API를 직접 조회하여 PTAX 달러의 공식 고시 환율을 제공합니다: https://olinda.bcb.gov.br/olinda/servico/PTAX/versao/v1/odata/

도구

• get_ptax_by_date(date) — 특정 날짜(YYYY-MM-DD)의 PTAX 마감 환율.

• get_ptax_by_period(startDate, endDate) — 두 날짜 사이의 마감 환율 시계열.

• get_ptax_latest(lookbackDays?) — 사용 가능한 가장 최근의 마감 환율(최근 lookbackDays일 이내에서 조회하며, 기본값은 7).

반환되는 모든 환율은 마감(공식 PTAX) 고시이며, 매수·매도 가격과 고시 시각(브라질리아 시간)을 포함합니다.

Related MCP server: Frankfurter MCP

빌드

npm install
npm run build

MCP Inspector로 테스트

npm run inspector

Claude Desktop / Claude Code에서 설정

MCP 설정 파일(claude_desktop_config.json 또는 그에 상당하는 파일)에 추가하세요:

{
  "mcpServers": {
    "query-ptax-bcb": {
      "command": "node",
      "args": ["D:/GitHub/master-mils/query-ptax-bcb/dist/index.js"]
    }
  }
}