음성 인식 기반 암호화폐 AI 에이전트 개발 가이드 (Next.js + Google Gemini + LunarCrush MCP)
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
웹 개발
대상자
- 대상: Next.js, TypeScript, AI API 사용 경험자 (초보자 ~ 중급자)
- 난이도: 기초 React/TypeScript 지식 필요, API 키 설정 및 환경 변수 관리 기초 요구
핵심 요약
- 음성 인터페이스:
@google/generative-ai를 활용한 자연어 처리로Bitcoin등 암호화폐 심볼 자동 인식 - MCP 통합:
@modelcontextprotocol/sdk를 통해 LunarCrush의 사회적 분석 데이터와 실시간 연결 - 프로덕션 배포:
AWS Amplify를 통한 환경 변수 보안 처리 및 배포
섹션별 세부 요약
1. 프로젝트 개요
- 암호화폐 분석의 수동적 작업(차트 스크롤, 수동 API 연동) 대체
- MCP 기반 AI가 실시간 데이터 소스(가격, 소셜 메트릭, 기술 지표) 통합 분석
- "What's the sentiment on Bitcoin?"과 같은 음성 명령으로 종합 분석 제공
2. 핵심 기능
- 음성 인식:
react-speech-recognition을 통한 음성 제어 (속도, 볼륨, 일시정지) - AI 오케스트레이션: Google Gemini이 암호화폐 심볼 추출 및 MCP 통합
- UI/UX: Material-UI 기반 블랙 테마 디자인, 실시간 분석 시각화
3. 개발 환경 설정
- 필요 요건: Node.js 18+ 설치,
@google/generative-ai,@modelcontextprotocol/sdk,@mui/material패키지 설치 - 환경 변수:
.env.local파일에LUNARCRUSH_API_KEY및GEMINI_API_KEY설정 - 예시 명령어:
```bash
npx create-next-app@latest voice-crypto-assistant --typescript --tailwind --eslint --app
npm install @google/generative-ai @modelcontextprotocol/sdk @mui/material @mui/icons-material
```
4. API 키 등록 절차
- LunarCrush:
- https://lunarcrush.com에 가입 후 API 키 생성
- 구독 계획 선택 후 API 인증 페이지에서 키 발급
- Google Gemini:
- https://aistudio.google.com에 가입
- Google 계정으로 인증 후 API 키 생성 (형식:
AIza...)
5. 코드 구조 및 핵심 함수
- 숫자 포맷 함수:
```typescript
export function formatLargeNumber(value: string | number): string {
// 1000 → "1K", 1000000 → "1M" 등으로 포맷
}
```
- 화폐 포맷 함수:
```typescript
export function formatCurrency(value: string | number): string {
// "$1,000" → "$1K" 등으로 자동 변환
}
```
결론
- 포트폴리오 프로젝트로 활용 가능한 AI 개발 패턴
- 핵심 배포 방법: AWS Amplify를 통한 환경 변수 보안 처리 및 배포
- 예시:
npm run dev실행 후http://localhost:3000에서 실시간 분석 확인 가능