Currency MCP Server (FastMCP)

환율 정보를 제공하는 Model Context Protocol (MCP) 서버입니다. Frankfurter API를 사용하여 실시간 환율 정보를 가져옵니다.

🚀 시작하기

1. 전제 조건

• Python 3.10 이상 설치 권장.

2. 설치

프로젝트 디렉토리에서 필요한 패키지를 설치합니다.

pip install -r requirements.txt

3. 서버 실행

서버를 실행하면 자동으로 FastMCP Inspector (도구 테스트 UI)가 활성화됩니다.

python server.py

실행 후 터미널에 표시되는 URL(예: http://127.0.0.1:8000)에 접속하여 도구를 직접 테스트할 수 있습니다.

🛠️ 제공하는 도구

1. get_exchange_rate: 두 통화 간의 환율을 계산합니다.

   • from_currency: 기준 통화 (예: USD)
   • to_currency: 대상 통화 (예: KRW)
   • amount: 변환할 금액 (기본값: 1.0)

2. list_supported_currencies: 지원되는 모든 통화 코드 목록을 확인합니다.

🤖 Claude Desktop 연정 (선택 사항)

Claude Desktop에서 이 서버를 사용하려면 claude_desktop_config.json 파일을 다음과 같이 수정하세요.

{
  "mcpServers": {
    "currency-exchange": {
      "command": "python",
      "args": [
        "C:/Users/KSJ/.gemini/antigravity/scratch/currency-mcp/server.py"
      ]
    }
  }
}

주의: Python 실행 경로와 server.py 파일의 절대 경로를 정확히 입력해야 합니다.