Moralis MCP Server

🧠 개요

Moralis MCP 서버 는 자연어 프롬프트를 실제 블록체인 통찰력에 연결하는 로컬 또는 클라우드 배포 가능 엔진으로, AI 모델이 사용자 정의 코드나 SQL 없이 지갑 활동, 토큰 메트릭, dapp 사용 등을 쿼리할 수 있도록 합니다.

모델 컨텍스트 프로토콜을 기반으로 구축된 이 서버를 사용하면 LLM이 일관되고 설명 가능하며 확장 가능한 방식으로 Moralis API와 쉽게 통신할 수 있습니다.

• 🔗 완벽한 플러그 가능: LLM 교체, 검색 논리 사용자 정의 또는 자체 도구로 확장 가능
• 🧱 OpenAI, Claude 및 오픈 소스 모델과 함께 작동합니다.
• 🧠 에이전트, DevTools, 봇, 대시보드 등을 지원합니다.

⚙️ 일반적인 사용 사례

• 🤖 AI 에이전트 및 보조원: "이 지갑의 거래 내역은 어떻게 되나요?"
• 📈 Devtools: 온체인 QA, 테스트, CLI 통합
• 📊 대시보드: 자연어에서 차트/데이터로
• 📉 모니터링: 토큰/dapp에 대한 알림 및 요약
• 🧠 트레이딩 봇: 실제 블록체인 기반을 갖춘 LLM 기반 전략

🔐 API 키 받기

이 MCP 서버를 Moralis API와 함께 사용하려면 API 키가 필요합니다.

1. Moralis 개발자 포털로 이동
2. 가입하고 로그인하세요
3. 메인 메뉴에서 API 키 페이지 로 이동합니다.
4. 키를 복사하여 구성 파일에서 구성하거나(다음 섹션 참조) 환경에서 설정하세요.

지엑스피1

⚠️ 참고: 일부 기능 및 엔드포인트는 Moralis 유료 플랜이 필요합니다. 모든 기능을 이용하고 프로덕션급 성능을 발휘하려면 유료 플랜에 가입하는 것이 좋습니다.

🚀 클라이언트와 함께 사용

MCP 서버를 호환 클라이언트(예: Claude Desktop, OpenAI 호환 에이전트, VS Code 확장 프로그램 등)에 연결하려면 클라이언트가 서버를 하위 프로세스로 시작하도록 구성합니다.

대부분의 클라이언트는 간단한 구성 파일을 지원합니다. 예를 들어, 다음과 같이 클라이언트의 구성 디렉토리에 mcp.json과 같은 파일을 만들 수 있습니다.

이 설정은 MCP 서버를 지원하는 모든 클라이언트에 적용할 수 있습니다. 예시 값을 사용 사례에 맞는 값으로 바꾸세요.

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop에 Moralis API 서버를 자동으로 설치하려면:

🖥️ 서버로 사용

서버는 전송 유형을 지정하기 위해 선택적 --transport 인수를 허용합니다. 사용 가능한 전송 유형은 다음과 같습니다.

• stdio : 표준 입출력을 통해 통신합니다(기본값).
• web : 통신을 위한 HTTP 서버를 시작합니다.
• streamable-http : 스트리밍 가능한 엔드포인트가 있는 HTTP 서버를 시작합니다.

예시

1. 기본 stdio 전송 사용 :

2. web 전송 사용 :

HTTP 서버가 시작됩니다. curl 이나 Postman 같은 도구를 사용하여 서버에 요청을 보낼 수 있습니다.

3. streamable-http 전송을 사용하여 :

HTTP 서버가 시작됩니다. curl 이나 Postman 같은 도구를 사용하여 서버에 요청을 보낼 수 있습니다.

노트

• 서버를 시작하기 전에 필수 환경 변수(예: MORALIS_API_KEY )가 설정되었는지 확인하세요.
• 사용자 정의 구성의 경우 필요에 따라 추가 인수나 환경 변수를 전달할 수 있습니다.
• 각 운송 유형에 대한 자세한 내용은 설명서를 참조하세요.

🛠 개발

종속성 설치:

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

🐞 디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

💬 예시 프롬프트

다음은 MCP 서버를 통해 AI 에이전트와 함께 사용할 수 있는 몇 가지 프롬프트 예시입니다.

이러한 프롬프트는 MCP 메서드 레지스트리를 사용하여 구조화된 Moralis API 호출에 구문 분석되고 매핑됩니다.

💡 지원되는 방법에 따라 사용자 정의 프롬프트를 작성할 수도 있습니다.

📚 API 참조

Moralis MCP 서버는 프롬프트를 Moralis REST API 호출로 래핑하고 변환합니다. 기본 API 표면은 다음에서 살펴볼 수 있습니다.

🔗 모랄리스 스웨거 문서(v2.2)

이 문서에서는 다음의 엔드포인트에 대해 설명합니다.

• 토큰 가격 책정
• 지갑 활동
• NFT 메타데이터 및 소유권
• 이체 및 거래
• 그리고 더 많은 것