# Currency MCP Server (FastMCP)

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

## 🚀 시작하기

### 1. 전제 조건
-   Python 3.10 이상 설치 권장.

### 2. 설치
프로젝트 디렉토리에서 필요한 패키지를 설치합니다.
```bash
pip install -r requirements.txt
```

### 3. 서버 실행
서버를 실행하면 자동으로 FastMCP Inspector (도구 테스트 UI)가 활성화됩니다.
```bash
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` 파일을 다음과 같이 수정하세요.

```json
{
  "mcpServers": {
    "currency-exchange": {
      "command": "python",
      "args": [
        "C:/Users/KSJ/.gemini/antigravity/scratch/currency-mcp/server.py"
      ]
    }
  }
}
```
*주의: Python 실행 경로와 `server.py` 파일의 절대 경로를 정확히 입력해야 합니다.*