UZCBU MCP Server

우즈베키스탄 중앙은행(CBU.uz)의 공식 환율을 모든 MCP 호환 AI 어시스턴트(Claude Desktop, Claude Code 등)에 연결하는 Model Context Protocol (MCP) 서버입니다.

MCP는 2024-2025년에 등장하여 2026년까지 AI 세계에서 널리 확산되고 있는 개방형 표준으로, AI 모델을 외부 데이터 및 시스템에 연결하는 데 사용됩니다. 이 프로젝트는 우즈베키스탄을 위한 그러한 서버 중 하나입니다.

할 수 있는 일

• get_all_rates — 오늘의 모든 통화 공식 환율을 반환합니다

• get_exchange_rate — 특정 통화(예: USD)의 오늘 환율을 반환합니다

• get_historical_rate — 특정 과거 날짜의 환율을 반환합니다

• convert_currency — 두 통화 간 공식 환율로 환전합니다(예: 100 USD가 몇 EUR인지 계산)

데이터 출처: cbu.uz 공식 공개 JSON API. API 키나 등록이 필요 없습니다.

Related MCP server: Realtime Exchange Rate MCP Server

설치

git clone https://github.com/<sizning-username>/uzcbu-mcp-server.git
cd uzcbu-mcp-server
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

수동 실행(테스트용)

python -m uzcbu_mcp.server

서버는 표준 MCP stdio 전송을 통해 실행되며 MCP 클라이언트의 요청을 기다립니다.

Claude Desktop에 연결

Claude Desktop 구성 파일(claude_desktop_config.json)을 열고 다음을 추가하세요:

{
  "mcpServers": {
    "uzcbu-currency": {
      "command": "python",
      "args": ["-m", "uzcbu_mcp.server"],
      "cwd": "/to'liq/yo'l/uzcbu-mcp-server"
    }
  }
}

Claude Desktop을 다시 시작하세요. 이제 Claude에게 "오늘 달러 환율이 얼마인가요?" 또는 "100달러를 유로로 환전해 줘"라고 물어보면, Claude가 서버의 도구를 자동으로 호출합니다.

테스트

네트워크에 연결하지 않고(목 데이터로) 로직을 확인하려면:

python test_offline.py

프로젝트 구조

uzcbu-mcp-server/
├── uzcbu_mcp/
│   ├── __init__.py
│   └── server.py          # MCP server va barcha tool'lar
├── test_offline.py        # Mock ma'lumot bilan offline testlar
├── requirements.txt
├── pyproject.toml
└── README.md

이 프로젝트가 특별한 이유

이것은 단순한 "API 래퍼"가 아닙니다. AI 생태계의 새로운 표준인 Model Context Protocol 기반으로 구축되었으며, 즉 모든 MCP 호환 AI 클라이언트(단일 챗봇뿐만 아니라)가 이를 사용할 수 있습니다. 우즈베키스탄 맥락의 데이터(공식 중앙은행 환율)를 다루는 MCP 서버는 현재 매우 드뭅니다.

확장 아이디어

• 다른 CBU 통계 데이터(인플레이션, 금리) 추가

• 결과 캐싱(몇 분)을 통한 속도 향상

• Telegram 봇 또는 N8N 워크플로우와 통합

• HTTP/SSE 전송을 추가하여 원격으로 작동하는 서버 만들기

라이선스

MIT