Ping Agent Kit으로 구축된 MCP 서버

AI를 위한 온체인 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버로, 표준화된 인터페이스를 통해 솔라나 블록체인과 원활하게 상호 작용합니다. Ping Agent Kit 기반으로 구축된 이 구현을 통해 AI 에이전트는 블록체인 작업을 효율적으로 실행할 수 있습니다.

개요

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

• Solana 블록체인과 상호 작용

• 거래 실행

• 계정 정보 조회

• Solana 지갑 관리

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

Related MCP server: Solana MCP Server

필수 조건

• Node.js(v16 이상)

• pnpm(권장), npm 또는 yarn

• 개인 키가 있는 Solana 지갑

• 솔라나 RPC URL(메인넷, 테스트넷, 개발넷)

설치

옵션 1: npm에서 설치(Cursor/Cline과 같은 클라이언트에 권장)

지엑스피1

옵션 2: 소스에서 빌드

1. 이 저장소를 복제하세요:

2. 종속성 설치:

3. 프로젝트를 빌드하세요:

구성

환경 설정

자격 증명을 사용하여 .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을 추가합니다.

   npm을 통해 설치한 경우(옵션 1):

   { "mcpServers": { "solana-mcp": { "command": "npx", "args": ["ping-mcp"], "env": { "RPC_URL": "your_solana_rpc_url_here", "SOLANA_PRIVATE_KEY": "your_private_key_here", "OPENAI_API_KEY": "your_openai_api_key" // OPTIONAL }, "disabled": false, "autoApprove": [] } } }

   소스에서 빌드한 경우(옵션 2):

   { "mcpServers": { "solana-mcp": { "command": "node", "args": ["/path/to/ping-mcp/build/index.js"], "env": { "RPC_URL": "your_solana_rpc_url_here", "SOLANA_PRIVATE_KEY": "your_private_key_here", "OPENAI_API_KEY": "your_openai_api_key" // OPTIONAL }, "disabled": false, "autoApprove": [] } } }

3. 이러한 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.

프로젝트 구조

사용 가능한 도구

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

• GET_ASSET - Solana 자산/토큰에 대한 정보를 검색합니다.

• DEPLOY_TOKEN - Solana에 새 토큰 배포

• GET_PRICE - 토큰 가격 정보 가져오기

• WALLET_ADDRESS - 지갑 주소를 가져옵니다

• BALANCE - 지갑 잔액 확인

• TRANSFER - 지갑 간 토큰 전송

• MINT_NFT - 새로운 NFT를 생성하고 주조하세요

• TRADE - 토큰 거래 실행

• REQUEST_FUNDS - 자금 요청(테스트/개발에 유용)

• RESOLVE_DOMAIN - Solana 도메인 이름 확인

• GET_TPS - Solana에서 초당 현재 거래 내역 가져오기

보안 고려 사항

• 개인 키를 안전하게 보관하고 절대 공유하지 마세요.

• 민감한 정보에는 환경 변수를 사용하세요

• AI 에이전트 작업에 전용 지갑을 사용하는 것을 고려하세요.

• AI 에이전트 활동을 정기적으로 모니터링하고 감사합니다.

• 메인넷 이전에 Devnet/testnet에서 테스트 운영

문제 해결

문제가 발생하는 경우:

1. Solana 개인 키가 올바른지 확인하세요

2. RPC URL에 액세스할 수 있는지 확인하세요

3. 의도한 네트워크(메인넷, 테스트넷 또는 데브넷)에 있는지 확인하세요.

4. 오류 메시지에 대한 Claude Desktop 로그를 확인하세요.

5. 빌드가 성공했는지 확인하세요

종속성

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

• @solana/web3.js

• @modelcontextprotocol/sdk

• ping-agent-kit

기여하다

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

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 라이선스에 따라 라이선스가 부여되었습니다.