Skip to main content
Glama
Sign In
fx-report-mcp

fx-report-mcp

by ddadasoft
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

public-data-report-mcp

샘플 프로젝트입니다. 공개 데이터 API, 엑셀 자동화, MCP 서버 연결을 한 저장소에서 보여 주려고 만든 예제이며, 고객 작업물이 아닙니다.

키 없이 쓰는 공개 환율 API Frankfurter(유럽중앙은행 기준 환율)에서 기간별 환율을 모아 엑셀(.xlsx) 보고서를 만듭니다. 같은 기능을 두 가지로 씁니다.

  1. CLI 명령 fx-report: 터미널이나 예약 작업(cron)에서 실행합니다.

  2. MCP 서버 fx-report-mcp (공식 MCP Python SDK, stdio): Claude Code 같은 AI 에이전트가 도구 make_fx_report로 부릅니다. 예: "지난 한 달 달러 대비 원화·엔화 환율 보고서를 엑셀로 만들어 줘."

보고서 내용:

  • 요약 시트: 통화별 시작값, 마지막 값, 최저, 최고, 평균, 변동률(%), 영업일 수, 통화별 추이 차트

  • 일별 환율 시트: 날짜별 환율 표 (주말과 휴일은 API가 빼고 줍니다)

보고서 미리보기

위 이미지는 아래 CLI 예로 실제 만든 fx-report.xlsx의 값을 읽어 그린 미리보기입니다.

설치

Python 3.10 이상이 필요합니다.

git clone https://github.com/ddadasoft/public-data-report-mcp
cd public-data-report-mcp
python3 -m venv .venv
.venv/bin/pip install -e '.[test]'

Related MCP server: FX Currency MCP Server

CLI 실행

.venv/bin/fx-report --base USD --symbols KRW,JPY,EUR --start 2026-10-14 --end 2026-11-13 -o fx-report.xlsx

실제 출력:

USD 기준, 2026-10-14 ~ 2026-11-13, 영업일 23일
통화            시작      마지막        최저        최고    변동률
KRW       1,336.7900  1,337.1300  1,324.4500  1,358.7300    +0.03%
JPY         158.4500    160.0000    156.8000    160.0000    +0.98%
EUR           0.8933      0.9048      0.8875      0.9048    +1.29%
저장: fx-report.xlsx

옵션:

옵션

기본값

설명

--base

USD

기준 통화

--symbols

KRW,JPY,EUR

쉼표로 구분한 대상 통화

--start, --end

오늘부터 --days일 전 ~ 오늘

기간 (YYYY-MM-DD)

--days

30

--start가 없을 때 쓰는 기간 일수

-o, --output

fx-report.xlsx

저장할 파일

지원하지 않는 통화나 자료가 없는 기간을 주면 오류 문장을 출력하고 종료 코드 1로 끝납니다.

Claude Code에 MCP 서버 연결

설치한 폴더에서 아래 명령을 실행합니다. --scope project는 이 폴더의 .mcp.json에 설정을 저장합니다.

claude mcp add fx-report --scope project -- "$(pwd)/.venv/bin/fx-report-mcp"

직접 .mcp.json을 쓸 때는 다음과 같습니다(경로는 설치 위치로 바꿉니다).

{
  "mcpServers": {
    "fx-report": {
      "command": "/절대/경로/public-data-report-mcp/.venv/bin/fx-report-mcp",
      "args": []
    }
  }
}

연결한 뒤 Claude Code에서 "USD 대비 KRW, JPY 환율을 11월 1일부터 13일까지 엑셀로 만들어 줘"라고 요청하면 make_fx_report 도구가 파일을 만들고 요약 표를 돌려줍니다. 도구 응답 예:

저장: /private/tmp/fx-demo/mcp.xlsx

통화            시작      마지막        최저        최고    변동률
KRW       1,342.9000  1,337.1300  1,334.1000  1,358.7300    -0.43%
JPY         157.9000    160.0000    157.9000    160.0000    +1.33%

테스트

네트워크 대신 고정 응답을 씁니다.

.venv/bin/python -m pytest -q

구조

src/report_mcp/
  rates.py    Frankfurter API 호출과 응답 검사
  report.py   요약 계산, 엑셀 작성(openpyxl), 텍스트 표
  cli.py      fx-report 명령
  server.py   fx-report-mcp MCP 서버 (도구 make_fx_report)
tests/test_report.py

다른 공개 API(공공데이터, 날씨, 주가 등)로 바꿀 때는 rates.py만 바꾸면 엑셀 작성, CLI, MCP 서버는 그대로 씁니다.

라이선스

MIT. 환율 데이터의 출처는 Frankfurter API와 유럽중앙은행입니다.

Available Tools

1 tool
make_fx_reportA

공개 환율(ECB 기준, Frankfurter API)을 기간별로 모아 엑셀 보고서를 만든다.

symbols: 쉼표로 구분한 대상 통화 (예: "KRW,JPY") base: 기준 통화 (예: "USD") start, end: YYYY-MM-DD. 없으면 오늘부터 days일 전까지 output: 저장할 .xlsx 경로 (상대 경로는 서버 작업 폴더 기준) 반환: 저장 경로와 통화별 요약 표

Inputs: end, base, days, start, +2 more. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusing it with another operation. Its purpose—building an FX Excel report—is clearly stated.

    Naming Consistency5/5

    The single tool follows a clear verb_noun convention (make_fx_report) and is written in snake_case. Consistency is trivially satisfied with one tool, and the naming is descriptive.

    Tool Count3/5

    One tool is thin for a server, even a narrowly focused one. A single make-report function is reasonable for the stated purpose, but the surface feels minimal and offers no discovery or validation helpers.

    Completeness3/5

    The tool covers report generation end to end, including symbols, base, date range, and output path. However, there is no way to discover supported currencies, validate symbols, or retrieve raw rates, which are gaps that could cause agent trial-and-error.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Frankfurter MCP

      jessicayanwang
      A
      license
      A
      quality
      D
      maintenance
      Provides access to currency exchange rates and conversion tools using the Frankfurter API, including latest rates, historical data, and time series from sources like the European Central Bank.
      5
      MIT

    • FX Currency MCP Server

      pavm035
      F
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time and historical foreign exchange rates for 31+ currencies, enabling currency conversion, historical rate lookups, and time series analysis using data from the Frankfurter API.
      -

    • Frankfurter Currency Exchange

      GAKUGO
      F
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time and historical exchange rate data for JPY against major currencies using the Frankfurter API. It enables AI agents to perform currency conversions and generate detailed Japanese Yen fluctuation analysis reports.
      -

    • Currency MCP Server

      SEJIN0419
      F
      license
      Not graded
      quality
      D
      maintenance
      Enables fetching real-time exchange rates between currencies and listing supported currency codes using the Frankfurter API.
      -