crypto-portfolio-mcp

암호화폐 포트폴리오 MCP

암호화폐 포트폴리오 할당을 추적하고 관리하기 위한 MCP 서버로, AI 에이전트가 포트폴리오 전략을 실시간으로 쿼리하고 최적화할 수 있도록 지원합니다.

특징

• 포트폴리오 관리 : 실시간 바이낸스 가격을 통해 암호화폐 보유량을 추가하고 추적하세요.
• 가격 검색 : 모든 Binance 거래 쌍(예: BTC/USDT)의 현재 가격을 가져옵니다.
• 가치 내역 : 시간 경과에 따른 포트폴리오 가치의 시각적 차트를 생성합니다.
• 분석 프롬프트 : 다각화 및 위험 제안을 포함한 포트폴리오 분석을 위한 사전 구축된 프롬프트입니다.
• SQLite 저장소 : 로컬 데이터베이스에 보유 항목을 영구적으로 저장합니다.

설치

필수 조건

• 파이썬 3.10+
• Git(선택 사항, 저장소 복제용)
• 호환되는 MCP 클라이언트(예: Claude Desktop )

설정

1. 저장소 복제 :지엑스피1
2. 설치 요구 사항 :
   pip install mcp[cli] ccxt matplotlib
3. Claude Desktop에 설치 :
   mcp install main.py --name "CryptoPortfolioMCP"
   또는 구성 파일을 수동으로 업데이트합니다.
   { "mcpServers": { "crypto-portfolio-mcp": { "command": "python", "args": [ "path/to/crypto-portfolio-mcp/main.py" ] } } }

용법

설치가 완료되면 Claude Desktop과 같은 MCP 클라이언트를 통해 서버와 상호 작용합니다. 아래는 명령 예시입니다.

홀딩 추가

• 프롬프트 : "내 포트폴리오에 0.1 BTC를 추가하세요"
• 결과 : 포트폴리오에 0.1 BTC/USDT가 추가되고 "포트폴리오에 0.1 BTC/USDT가 추가되었습니다"라는 메시지가 표시됩니다.

현재 가격 받기

• 프롬프트 : "바이낸스에서 현재 ETH 가격은 얼마인가요?"
• 결과 : "Binance에서 ETH/USDT의 현재 가격: $2000.50"을 반환합니다(예시 가격).

포트폴리오 요약

• 프롬프트 : "현재 내 포트폴리오 요약은 무엇입니까?"
• 결과 : 형식화된 요약이 표시됩니다. 예:
  Portfolio Summary: BTC/USDT: 0.1 @ $60000.00 = $6000.00 ETH/USDT: 2.0 @ $2000.00 = $4000.00 Total Value: $10000.00

포트폴리오 가치 내역

• 프롬프트 : "내 포트폴리오 가치 내역을 보여주세요"
• 결과 : 시간 경과에 따른 포트폴리오 가치의 PNG 차트를 생성하고 표시합니다.

포트폴리오 분석

• 프롬프트 : "내 암호화폐 포트폴리오를 분석해 주세요"
• 결과 : 현재 보유 자산과 바이낸스 시장 동향을 기반으로 한 분석 및 제안을 제공합니다.

도구

서버는 다음 도구를 제공합니다.

• get_portfolio_summary : 현재 포트폴리오의 텍스트 요약을 검색합니다.
• add_holding(coin_symbol: str, amount: float) : 암호화폐 보유량을 추가합니다(예: "BTC", 0.1).
• get_price(coin_symbol: str) : Binance에서 거래 쌍의 현재 가격을 가져옵니다.
• portfolio_value_history() : 포트폴리오 가치 내역의 PNG 차트를 생성합니다.

자세한 매개변수 설명은 소스 코드의 docstring을 참조하세요.

데이터 베이스

보유 자산은 다음 스키마를 사용하여 SQLite 데이터베이스( portfolio.db )에 저장됩니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스를 참조하세요.