mcp4crypto by teasdm - MCP Server

ChainAgent (가칭)

AI 에이전트를 위한 온체인 분석 MCP(Model Context Protocol) 서버

📋 프로젝트 개요

ChainAgent는 AI 에이전트들이 암호화폐 온체인 데이터를 쉽게 분석할 수 있도록 도와주는 MCP 서버입니다. 기존의 API 기반 서비스들과 달리, AI 에이전트가 직접 활용할 수 있는 도구 형태로 온체인 분석 기능을 제공합니다.

핵심 차별화 포인트

AI 에이전트 특화: MCP 표준을 통한 AI 친화적 인터페이스
온체인 분석 중심: 지갑 분석, 가격 추적, 프리미엄 분석 등
통합 API: 여러 데이터 소스를 하나의 인터페이스로 통합

🎯 타겟 시장

직접 경쟁자: Armor Crypto (거래 중심) vs ChainAgent (분석 중심)
간접 경쟁자: CoinAPI, Crypto APIs 등 (API 기반 vs MCP 기반)
타겟 고객: AI 에이전트 개발자, 크립토 트레이더, 핀테크 스타트업

🚀 MVP 기능

1. 지갑 정보

get_wallet_balance(address, chain) - 지갑 잔액 조회
get_wallet_tokens(address, chain, limit=10) - 보유 토큰 목록
get_wallet_tx_count(address, chain) - 트랜잭션 개수

2. 가격 정보

get_token_price(token_id, vs_currency="usd") - 현재 가격
get_price_history(token_id, days=7) - 가격 히스토리
compare_exchange_prices(symbol, exchanges) - 거래소별 가격 비교

3. 프리미엄 분석

get_kimchi_premium(symbol) - 김치프리미엄 계산
find_arbitrage_opportunities(symbols, min_premium=1.0) - 아비트라지 기회 탐지

4. 시장 정보

get_trending_tokens(limit=10) - 트렌딩 토큰
get_market_overview() - 시장 개요
get_gas_price(chain="ethereum") - 가스비 조회

🛠 기술 스택

Backend

Language: Python 3.9+
Framework: FastAPI
MCP Protocol: Anthropic MCP Python SDK
Caching: Redis

APIs & Libraries

CoinGecko API: 가격, 시가총액, 트렌딩 데이터
CCXT: 200+ 거래소 통합 API
Etherscan API: 온체인 지갑 데이터
Web3.py: 이더리움 블록체인 상호작용

Data Processing

pandas: 데이터 분석 및 처리
numpy: 수치 계산
aiohttp: 비동기 HTTP 클라이언트

Infrastructure

Deployment: AWS Elastic Beanstalk
Containerization: Docker
Cache: Redis (ElastiCache)

📁 프로젝트 구조

chainagent/
├── src/
│   ├── mcp_server/
│   │   ├── __init__.py
│   │   ├── server.py          # MCP 서버 메인
│   │   └── tools/             # MCP 도구들
│   │       ├── wallet.py      # 지갑 관련 도구
│   │       ├── price.py       # 가격 관련 도구
│   │       └── premium.py     # 프리미엄 분석
│   ├── clients/               # API 클라이언트들
│   │   ├── coingecko.py
│   │   ├── ccxt_client.py
│   │   └── etherscan.py
│   ├── utils/
│   │   ├── cache.py          # 캐싱 로직
│   │   └── config.py         # 설정 관리
│   └── main.py
├── tests/
├── docker/
│   ├── Dockerfile
│   └── docker-compose.yml
├── requirements.txt
├── Dockerrun.aws.json        # EB 배포용
└── README.md

⚡ 성능 최적화 전략

캐싱 전략

가격 데이터: 1분 캐싱 (빠른 변동)
지갑 정보: 5분 캐싱 (상대적으로 안정적)
시장 데이터: 10분 캐싱 (덜 빈번한 변화)

비동기 처리

여러 거래소 가격 조회 시 병렬 처리
API 호출 타임아웃 설정 (3-5초)
Rate limit 자동 조절

🔧 개발 환경 설정

Prerequisites

Python 3.9+
Redis
Docker
AWS CLI (배포용)

Installation

# Repository clone
git clone <repo-url>
cd chainagent

# Virtual environment
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
venv\Scripts\activate     # Windows

# Dependencies
pip install -r requirements.txt

# Environment variables
cp .env.example .env
# Edit .env with your API keys

Environment Variables

# API Keys
COINGECKO_API_KEY=your_key_here
ETHERSCAN_API_KEY=your_key_here

# Redis
REDIS_URL=redis://localhost:6379

# Server
PORT=8000
DEBUG=True

🚀 배포

Docker 빌드

docker build -t chainagent .
docker run -p 8000:8000 chainagent

AWS Elastic Beanstalk 배포

# EB CLI 설치 및 초기화
pip install awsebcli
eb init

# 배포
eb create chainagent-prod
eb deploy

📊 비즈니스 모델

수익화 전략

Freemium: 기본 기능 무료, 고급 분석 유료
API 호출량 기반: 월간 호출 제한
엔터프라이즈: 전용 인스턴스, SLA 보장

예상 비용 구조

API 비용: Etherscan Pro ($99/월), CoinGecko Pro ($129/월)
인프라: AWS EB + ElastiCache (~$50-100/월)
개발/운영: 1인 개발자 부업 프로젝트

🎯 로드맵

Phase 1 - MVP (1-2개월)

프로젝트 기획 및 설계
기본 MCP 서버 구축
지갑 정보, 가격 조회 기능
Docker 컨테이너화

Phase 2 - 고도화 (2-3개월)

프리미엄 분석 기능
캐싱 시스템 구축
AWS 배포 자동화
기본 모니터링

Phase 3 - 확장 (3-6개월)

복잡한 온체인 플로우 분석
실시간 알림 시스템
사용자 대시보드
결제 시스템 연동

📄 라이센스

MIT License

🤝 기여하기

이 프로젝트는 1인 개발자의 부업 프로젝트로 시작되었습니다. 기여를 환영합니다!

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

📞 연락처

프로젝트 링크: [GitHub Repository]
이슈 리포트: [GitHub Issues]

“AI 에이전트가 온체인 세계를 이해할 수 있게 하자”