ASEANLINE MCP Server

Claude Desktop에서 ASEANLINE Gaming API를 사용할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.

설치

npm install -g aseanline-mcp

빠른 시작 (3단계)

1. 설정 파일 생성

aseanline-mcp init

2. 설정 파일 편집

nano ~/.aseanline/.env

ASEANLINE 담당자에게 받은 정보를 입력합니다:

• ASEANLINE_API_URL: API 서버 주소
• ASEANLINE_AGENT_CODE: 에이전트 코드
• ASEANLINE_PRIVATE_KEY: RSA 개인키

3. Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "aseanline": {
      "command": "aseanline-mcp"
    }
  }
}

Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop을 재시작하면 완료!

사용 예시

Claude Desktop에서:

"게임 제공사 목록 보여줘"
"testplayer001로 Gates of Olympus 게임 실행해줘"
"testplayer001 잔액 확인해줘"

CLI 명령어

| 명령어 | 설명 | |--------|------| | aseanline-mcp | MCP 서버 실행 (Claude Desktop용) | | aseanline-mcp init | 설정 파일 생성 (~/.aseanline/.env) | | aseanline-mcp version | 버전 표시 | | aseanline-mcp help | 도움말 표시 |

사용 가능한 도구

Integration API (5개)

| 도구명 | 설명 | |--------|------| | aseanline_agent_balance | 에이전트 잔액 조회 | | aseanline_game_providers | 게임 제공사 목록 조회 | | aseanline_games | 특정 제공사의 게임 목록 조회 | | aseanline_launch_game | 게임 시작 URL 생성 | | aseanline_kick_player | 플레이어 세션 종료 |

Balance Transfer API (7개)

| 도구명 | 설명 | |--------|------| | aseanline_create_player | 플레이어 생성 | | aseanline_player_balance | 플레이어 잔액 조회 | | aseanline_query_player_balances | 다중 플레이어 잔액 조회 (최대 200명) | | aseanline_query_all_player_balances | 전체 플레이어 잔액 조회 | | aseanline_deposit | 플레이어에게 입금 | | aseanline_withdraw | 플레이어에서 출금 | | aseanline_transfer_result | 입출금 결과 조회 |

Data Feed API (8개)

| 도구명 | 설명 | |--------|------| | aseanline_transaction | 특정 트랜잭션 조회 | | aseanline_transactions | 트랜잭션 목록 조회 | | aseanline_transactions_by_period | 기간별 트랜잭션 조회 | | aseanline_open_game_history | 게임 기록 페이지 URL | | aseanline_game_round_details_by_id | 라운드 ID로 상세 조회 | | aseanline_game_round_details | 게임 라운드 상세 조회 | | aseanline_now_playing | 현재 플레이 중인 플레이어 | | aseanline_game_sessions_closed | 종료된 게임 세션 조회 |

RSA 키 생성

아직 RSA 키가 없다면:

# 개인키 생성
openssl genpkey -algorithm RSA -out private_key.pem -pkeyopt rsa_keygen_bits:2048

# 공개키 추출
openssl rsa -pubout -in private_key.pem -out public_key.pem

• public_key.pem: ASEANLINE에 제출
• private_key.pem: ~/.aseanline/.env에 입력

Rate Limits

| API | 제한 | |-----|------| | 전체 | 분당 5,000회 | | LaunchGame | 분당 1,500회 | | Deposit/Withdraw | 초당 20회 | | PlayerBalance | 초당 40회 |

문제 해결

"환경변수가 설정되지 않았습니다"

# 설정 파일 확인
cat ~/.aseanline/.env

"GameProviderAPIError"

게임 실행 시 nickname 필드가 자동으로 설정됩니다. 최신 버전인지 확인하세요:

npm update -g aseanline-mcp

Claude Desktop에서 MCP 도구가 안 보임

1. Claude Desktop 재시작
2. 설정 파일 확인: cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

상세 가이드

더 자세한 설정 가이드는 SETUP_GUIDE.md를 참조하세요.

라이선스

MIT

링크

• GitHub
• Issues