MantraChain MCP 서버
MantraChain(Cosmos SDK) 블록체인과 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 MCP 프로토콜을 사용하여 토큰 전송, 검증자 위임, 잔액 조회 등의 기능을 제공하는 도구를 제공합니다.
특징
- 다른 주소로 토큰 보내기(은행 송금)
- 검증자에게 토큰 위임(스테이킹)
- 계정 잔액 조회
- 검증자 정보 가져오기
- 임의의 거래에 서명하고 방송합니다.
- 환경 변수를 통해 니모닉 및 네트워크 구성
- 듀콩 테스트넷과 메인넷 중 선택
- stdio와 HTTP+SSE 전송 모드를 모두 지원합니다.
사용 가능한 도구
은행 운영
- bank-send : 다른 주소로 토큰을 보냅니다.
- get-balance : 주소의 잔액을 가져옵니다(주소가 제공되지 않으면 기본적으로 사용자 주소로 설정됨)
스테이킹 작업
- 위임 : 검증자에게 토큰을 위임/스테이킹합니다.
- undelegate : 검증자로부터 토큰 위임 취소/스테이킹 취소
- claim-rewards : 특정 검증자에 대한 보상을 청구합니다.
- get-validators : 모든 검증기를 가져옵니다
- get-delegations : 주소에 대한 현재 스테이킹 정보를 가져옵니다.
- get-available-rewards : 주소에 대해 사용 가능한 모든 보상을 받습니다.
네트워크 운영
- get-account-info : 현재 계좌 정보 가져오기
- get-block-info : 블록 정보 가져오기
- query-network : 체인 API에 대한 일반 네트워크 쿼리를 실행합니다.
IBC 운영
- ibc-transfer : IBC 전송을 통해 토큰 전송
스마트 계약 운영
- contract-query : 읽기 전용 함수를 실행하여 스마트 계약을 쿼리합니다.
- contract-execute : 스마트 계약에서 상태를 변경하는 함수를 실행합니다.
DEX 운영
- dex-get-pools : DEX에서 사용 가능한 모든 유동성 풀을 가져옵니다.
- dex-find-routes : 두 토큰 간의 사용 가능한 스왑 경로를 찾습니다.
- dex-simulate-swap : 토큰 스왑을 실행하지 않고도 예상 결과를 얻기 위해 토큰 스왑을 시뮬레이션합니다.
- dex-swap : 슬리피지 보호 기능이 있는 DEX에서 토큰 스왑을 실행합니다.
거래 작업
- sign-and-broadcast : 일반 트랜잭션에 서명하고 브로드캐스트합니다.
사용 가능한 리소스
- networks://all : 구성을 포함한 모든 사용 가능한 네트워크를 보여주는 JSON 리소스
- openapi://{networkName} : 지정된 네트워크에 대한 OpenAPI/Swagger 사양
서버 실행
서버는 두 가지 모드로 실행될 수 있습니다.
- 표준 입출력 모드(기본값): 표준 입출력(STDIO)을 통해 통신합니다. 서버를 직접 실행하거나
npx 통해 실행할 때 기본 모드입니다.지엑스피1 - HTTP+SSE 모드: 3000번 포트에서 HTTP 서버를 실행하고 SSE(Server-Sent Events)를 통해 통신합니다.
-r 플래그 또는 전용 npm 스크립트를 사용하여 이 모드를 활성화하세요.# Using installed package
mantrachain-mcp -r
# Using npx
export MNEMONIC="YOUR_MNEMONIC"
export CUSTOM_NETWORKS="YOUR_CUSTOM_NETWORKS_JSON"
npx -y mantrachain-mcp@latest -- -r
GET /sse : SSE 연결을 설정합니다.POST /messages?sessionId=<id> : 클라이언트 요청을 수신합니다.
MCP 구성
Smithery를 통해 설치
Smithery를 통해 Claude Desktop에 MantraChain MCP 서버를 자동으로 설치하려면:
npx -y @smithery/cli install @allthatjazzleo/mantrachain-mcp --client claude
MCP 클라이언트 애플리케이션과 통합하려면 MCP 클라이언트 구성 파일에 서버 구성을 추가하세요.
{
"mcpServers": {
"mantrachain-mcp": {
"command": "npx",
"args": [
"-y",
"mantrachain-mcp@latest"
],
"env": {
"MNEMONIC": "YOUR_MNEMONIC",
"CUSTOM_NETWORKS": "{\"my-custom-net\":{\"rpcEndpoint\":\"https://rpc.custom-network.io\",\"apiEndpoint\":\"https://api.custom-network.io\",\"chainId\":\"my-custom-net-1\",\"prefix\":\"custom\",\"denom\":\"ucustom\",\"gasPrice\":\"0.01\",\"isMainnet\":false}}"
}
}
}
}
클라인 에서 원격 MCP 서버 연결:
{
"mcpServers": {
"mantrachain-mcp-sse": {
"url": "http://localhost:3000/sse",
"transportType": "sse"
}
}
}
글로벌하게가 아닌 로컬로 패키지를 빌드하는 경우
패키지를 빌드한 후에는 빌드 디렉터리에서 바로 실행할 수 있습니다. your_path 빌드 디렉터리의 실제 경로로 바꿔야 합니다.
그러면 다음 구성을 사용할 수 있습니다.
{
"mcpServers": {
"mantrachain-mcp": {
"command": "node",
"args": [
"your_path/mantrachain-mcp/build/index.js"
],
"env": {
"MNEMONIC": "YOUR_MNEMONIC"
}
}
}
}
환경 변수
- MNEMONIC : 필수. 지갑에서 사용할 니모닉 시드 문구입니다.
- CUSTOM_NETWORKS : 선택 사항. 추가 네트워크 구성을 포함하는 JSON 문자열입니다.