upbit-mcp-server/README.md

업비트 암호화폐 정보를 제공하는 MCP 서버

# 🪙 Upbit MCP Server

Claude Desktop에서 업비트 암호화폐 정보를 실시간으로 조회할 수 있는 MCP 서버입니다.

## ✨ 주요 기능

- 🔍 **개별 코인 시세 조회**: 비트코인, 이더리움 등 모든 업비트 코인
- 📊 **다중 코인 시세**: 여러 코인을 한 번에 조회
- 🔎 **마켓 검색**: 코인 이름으로 간편 검색
- 💰 **원화 마켓**: 인기 원화 마켓 시세 한눈에 보기
- 📈 **상세 정보**: 24시간 거래량, 52주 고저가, 변동률 등

## 🚀 설치 방법

### 1. NPM 설치
```bash
npm install -g upbit-mcp-server
```

### 2. Claude Desktop 설정

#### Windows
`%APPDATA%\Claude\claude_desktop_config.json` 파일을 열고:

#### macOS  
`~/Library/Application Support/Claude/claude_desktop_config.json` 파일을 열고:

다음 설정을 추가하세요:

```json
{
  "mcpServers": {
    "upbit": {
      "command": "upbit-mcp-server"
    }
  }
}
```

### 3. Claude Desktop 재시작

Claude Desktop을 완전히 종료하고 다시 시작하면 업비트 기능을 사용할 수 있습니다!

## 💬 사용 예시

Claude에서 다음과 같이 질문해보세요:

- **개별 코인 조회**: "비트코인 시세 알려줘" 또는 "KRW-BTC 가격은?"
- **다중 조회**: "비트코인, 이더리움, 리플 시세 보여줘"
- **코인 검색**: "도지코인 마켓 코드 알려줘"
- **인기 코인**: "원화 마켓 인기 코인들 시세 보여줘"
- **마켓 목록**: "업비트에서 거래할 수 있는 코인 목록 보여줘"

## 🔧 개발자용

### 로컬 개발
```bash
git clone <repository-url>
cd upbit-mcp-server
npm install
npm run dev
```

### 빌드
```bash
npm run build
```

### 테스트
```bash
npm run test
```

## 📋 지원하는 도구

| 도구 이름 | 설명 |
|----------|------|
| `get_ticker` | 특정 코인의 현재 시세 조회 |
| `get_multiple_tickers` | 여러 코인 시세 일괄 조회 |
| `search_market` | 코인 이름으로 마켓 검색 |
| `get_krw_markets` | 원화 인기 마켓 시세 조회 |
| `get_markets` | 전체 마켓 목록 조회 |

## ⚠️ 주의사항

- 이 도구는 **투자 조언이 아닙니다**
- 실시간 데이터이지만 거래소 상황에 따라 지연될 수 있습니다
- 투자 결정은 본인 책임하에 신중히 하세요

## 🐛 문제 신고

버그나 기능 요청은 [GitHub Issues](https://github.com/jay/upbit-mcp-server/issues)에 등록해주세요.

## 📄 라이선스

MIT License

## 🔗 관련 링크

- [Upbit API 문서](https://docs.upbit.com/)
- [MCP 문서](https://modelcontextprotocol.io/)
- [Claude Desktop](https://claude.ai/desktop)

---

**⭐ 이 프로젝트가 유용하다면 GitHub에서 별표를 눌러주세요!**