Claude Desktop용 Agentipy MCP 서버

Claude AI에 온체인 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버로, 표준화된 인터페이스를 통해 Solana 블록체인과 상호 작용할 수 있도록 합니다. 이 구현은 Agentipy를 사용하며, AI 에이전트가 블록체인 작업을 원활하게 수행할 수 있도록 지원합니다.

개요

이 MCP 서버는 다음과 같은 도구를 제공하여 Claude의 역량을 확장합니다.

• Solana 블록체인과 상호 작용
• 거래 실행
• 계정 정보 조회
• Solana 지갑 관리
• 가격 예측 받기
• 토큰 거래 및 지분
• 새로운 토큰 배포
• CoinGecko에서 토큰 정보 가져오기
• deBridge를 사용하여 크로스 체인 브리지 거래 실행
• Pyth Network에서 실시간 가격 데이터를 받으세요
• CoinGecko에서 포괄적인 토큰 정보에 액세스하세요
• 추세 토큰 및 풀 모니터링
• 상위 수익자 및 시장 동향 추적
• 자세한 토큰 가격 데이터와 분석을 받아보세요

서버는 AI 에이전트를 위한 블록체인 상호작용을 표준화하기 위해 모델 컨텍스트 프로토콜 사양을 구현합니다.

필수 조건

• Python 3.8 이상
• Claude Desktop 설치됨
• 개인 키가 있는 Solana 지갑
• 솔라나 RPC URL(메인넷, 테스트넷, 개발넷)
• OpenAI API 키(선택 사항)
• Allora API 키(선택 사항)
• CoinGecko Pro API 키(선택 사항)

설치

옵션 1: 빠른 설치(권장)

지엑스피1

옵션 2: 수동 설정

1. 가상 환경 만들기:

2. 필요한 패키지를 설치하세요:

구성

환경 설정

자격 증명을 사용하여 .env 파일을 만듭니다.

Claude Desktop과 통합

Claude Desktop에 이 MCP 서버를 추가하려면 다음 단계를 따르세요.

1. Claude Desktop 구성 파일 찾기
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • 리눅스: ~/.config/Claude\claude_desktop_config.json
2. 구성 추가 구성 파일을 만들거나 편집하고 다음 JSON을 추가합니다.

   참고 : command 필드에 Unix/Mac 시스템의 경우 run_mcp.sh , Windows 시스템의 경우 run_mcp.bat 사용하세요. 시스템의 스크립트 파일에 대한 올바른 절대 경로를 사용해야 합니다.

   { "mcpServers": { "agentipy": { "command": "/path/to/your/run_mcp.sh", # Replace with .bat for Windows "env": { "RPC_URL": "your_solana_rpc_url_here", "SOLANA_PRIVATE_KEY": "your_private_key_here", "OPENAI_API_KEY": "your_openai_api_key", "ALLORA_API_KEY": "your_allora_api_key", "COINGECKO_PRO_API_KEY": "your_coingecko_api_key" }, "disabled": false, "autoApprove": ["GET_BALANCE", "GET_PRICE_PREDICTION"] } } }
3. 이러한 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.

프로젝트 구조

사용 가능한 도구

MCP 서버는 다음과 같은 블록체인 도구를 제공합니다.

솔라나 원주민의 행동

• GET_BALANCE - 지갑 잔액 확인
• TRANSFER - 지갑 간 토큰 전송
• DEPLOY_TOKEN - Solana에 새 토큰 배포

알로라 액션

• GET_PRICE_PREDICTION - 가격 예측 받기
• GET_ALL_TOPICS - 사용 가능한 주제 가져오기

목성의 행동

• STAKE_WITH_JUP - Jupiter를 사용하여 토큰 스테이킹
• TRADE_WITH_JUP - Jupiter를 사용하여 토큰 거래

DeBridge 액션

• CREATE_DEBRIDGE_TRANSACTION - deBridge Liquidity Network API를 사용하여 크로스 체인 브리지 트랜잭션을 생성합니다.
• EXECUTE_DEBRIDGE_TRANSACTION - deBridge Liquidity Network API를 사용하여 크로스 체인 브리지 트랜잭션을 실행합니다.
• CHECK_TRANSACTION_STATUS - deBridge Liquidity Network API를 사용하여 크로스 체인 브리지 거래 상태를 확인합니다.

파이썬 액션

• PYTH_GET_PRICE - Pyth에서 코인 가격을 가져옵니다.

CoinGecko 액션

• COINGECKO_GET_TOKEN_INFO - CoinGecko에서 토큰 정보 가져오기
• COINGECKO_GET_COIN_PRICE_VS - Coingecko에서 특정 통화의 코인 가격을 알아보세요
• COINGECKO_GET_TOP_GAINERS - Coingecko에서 가장 많은 수익을 올린 기업을 알아보세요
• COINGECTO_GET_TRENDING_POOLS - Coingecko에서 인기 풀을 받아보세요
• COINGECKO_GET_TRENDING_TOKENS - Coingecko에서 인기 토큰을 받으세요
• COINGECKO_GET_TOKEN_PRICE_DATA - Coingecko에서 토큰 가격 데이터를 가져옵니다.
• COINGECKO_GET_LATEST_POOLS - Coingecko의 최신 풀을 받아보세요

보안 고려 사항

• 개인 키를 안전하게 보관하고 절대 공유하지 마세요.
• 민감한 정보에는 환경 변수를 사용하세요
• AI 에이전트 작업에 전용 지갑을 사용하는 것을 고려하세요.
• AI 에이전트 활동을 정기적으로 모니터링하고 감사합니다.
• 메인넷 이전에 Devnet/testnet에서 테스트 운영

문제 해결

문제가 발생하는 경우:

1. Solana 개인 키가 올바른지 확인하세요
2. RPC URL에 액세스할 수 있는지 확인하세요
3. 모든 종속성이 올바르게 설치되었는지 확인하세요
4. .env 파일에 올바른 자격 증명이 포함되어 있는지 확인하세요.
5. 오류 메시지에 대한 Claude Desktop 로그를 확인하세요.

종속성

주요 종속성은 다음과 같습니다.

• agentipy - Solana 블록체인 상호작용
• python-dotenv - 환경 관리
• mcp - 모델 컨텍스트 프로토콜

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
4. 브랜치에 푸시( git push origin feature/amazing-feature )
5. 풀 리퀘스트 열기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.