질문이나 문제가 있나요? GitHub Discussions에 남겨 주세요.

공식 Model Context Protocol 서버를 통해 AI 어시스턴트에서 바로 통화를 환전하고 현재 또는 과거 환율을 조회할 수 있습니다. 데이터는 1948년까지 거슬러 올라갑니다.

https://mcp.frankfurter.dev/를 원격 HTTP 서버로 추가하세요. API 키나 등록이 필요하지 않습니다.

설치

  1. 설정을 열고 앱(또는 커넥터)을 선택합니다.
  2. 오른쪽 위의 고급 설정을 클릭하고 개발자 모드를 활성화해 커스텀 앱을 허용합니다.
  3. 앱 하위 메뉴로 돌아가 앱 만들기(또는 커넥터 만들기)를 클릭합니다.
  4. 엔드포인트 URL을 입력합니다: https://mcp.frankfurter.dev/
  5. 인증 방식으로 없음을 선택합니다.

Claude Code에서:

claude mcp add frankfurter https://mcp.frankfurter.dev/

Claude Desktop 또는 Claude.ai에서:

  1. 설정을 열고 커넥터를 선택합니다.
  2. 커스텀 커넥터 추가를 클릭합니다.
  3. 엔드포인트 URL을 입력합니다: https://mcp.frankfurter.dev/
  4. 추가를 클릭해 마칩니다. 연결되면 채팅 화면에서 커넥터를 켭니다.

MCP 설정에 추가합니다(Cursor, Windsurf, VS Code 등):

{
  "mcpServers": {
    "frankfurter": {
      "url": "https://mcp.frankfurter.dev/"
    }
  }
}

도구

연결하면 어시스턴트가 다음 도구를 사용할 수 있습니다:

convert
두 통화 사이의 금액을 환전합니다. 환전 금액과 환율을 반환합니다.
파라미터:
  • amount (숫자, 필수): 환전할 금액.
  • from (문자열, 필수): 기준 통화의 세 자리 ISO 코드(예: USD).
  • to (문자열, 필수): 대상 통화의 세 자리 ISO 코드(예: EUR).
  • date (문자열, 선택): 과거 환율로 환전할 특정 날짜 YYYY-MM-DD.
  • provider (문자열, 선택): 종합 환율 대신 특정 기관의 공표 환율을 쓰기 위한 제공 기관 키. UST는 미국 재무부의 분기 보고 환율이며, 해당 분기 안의 날짜를 지정하면 그 시점에 적용된 환율을 반환합니다.
get_rates
기준 환율을 조회합니다.
파라미터:
  • date (문자열, 선택): 환율 날짜 YYYY-MM-DD(기본값: 최신).
  • base (문자열, 선택): 세 자리 기준 통화 코드(기본값: EUR).
  • quotes (문자열, 선택): 쉼표로 구분한 통화 코드로 결과를 필터링.
  • provider (문자열, 선택): 제공 기관 키. 제공 기관 자체의 기준 통화로 조회하면 공표된 숫자 그대로와 적용 시작일을 반환합니다.
list_currencies
지원하는 모든 ISO 4217 통화 코드와 이름을 나열합니다.
list_providers
provider를 고를 수 있도록 제공 기관의 키, 환율 유형, 갱신 주기, 제공 기간을 나열합니다.

시계열, 과거 기간, 대량 데이터가 필요하면 REST API를 사용하세요.