페넘브라 MCP 서버

페넘브라 블록체인과 상호작용하기 위한 도구를 제공하는 MCP 서버입니다. 이 서버는 거래 쿼리, 검증자 세트 정보, DEX 상태, 거버넌스 제안 등 페넘브라의 핵심 기능들과 개인 정보를 보호하면서 상호작용할 수 있도록 지원합니다.

특징

현재 도구

get_validator_set : 현재 검증자 세트 정보를 가져옵니다.
get_chain_status : 블록 높이와 체인 ID를 포함한 현재 체인 상태를 가져옵니다.
get_transaction : 특정 거래의 세부 정보를 가져옵니다.
get_dex_state : 최신 일괄 경매 결과를 포함한 현재 DEX 상태를 가져옵니다.
get_governance_proposals : 활성 거버넌스 제안을 받습니다.

계획된 기능

거래 제출
프라이빗 스테이킹 운영
DEX 거래(봉인 입찰 일괄 경매)
민간 거버넌스 투표
유동성 포지션 관리

설치

npm을 통해 패키지를 설치할 수 있습니다:

지엑스피1

또는 실을 사용하여:

yarn add @timeheater/penumbra-mcp

설정

출처로부터의 지역 개발

종속성 설치:

npm install

서버를 빌드하세요:

npm run build

개발 모드에서 실행:

npm run watch

Claude 데스크톱 통합

Claude 데스크톱과 통합하려면 다음 구성을 Claude 데스크톱 설정 파일( ~/Library/Application Support/Claude/claude_desktop_config.json )에 추가하세요.

{
  "mcpServers": {
    "penumbra-mcp": {
      "command": "node",
      "args": ["/Users/barton/infinity-topos/penumbra-mcp/build/index.js"],
      "env": {
        "PENUMBRA_NODE_URL": "https://rpc.penumbra.zone",
        "PENUMBRA_NETWORK": "mainnet",
        "PENUMBRA_CHAIN_ID": "penumbra-1",
        "PENUMBRA_REQUEST_TIMEOUT": "30000",
        "PENUMBRA_REQUEST_RETRIES": "5",
        "PENUMBRA_BLOCK_TIME": "6000",
        "PENUMBRA_EPOCH_DURATION": "100",
        "PENUMBRA_DEX_BATCH_INTERVAL": "60000",
        "PENUMBRA_DEX_MIN_LIQUIDITY": "1000",
        "PENUMBRA_DEX_MAX_PRICE_IMPACT": "0.05",
        "PENUMBRA_GOVERNANCE_VOTING_PERIOD": "1209600000",
        "PENUMBRA_GOVERNANCE_MIN_DEPOSIT": "100000"
      }
    }
  }
}

/path/to/penumbra-mcp 서버를 설치한 실제 경로로 바꾸세요.

MCP 서버 사용

구성이 완료되면 다음 도구를 사용하여 Claude를 통해 Penumbra와 상호 작용할 수 있습니다.

쿼리 검증기 세트:

Tell Claude: "Show me the current Penumbra validator set"

체인 상태 확인:

Tell Claude: "What's the current status of the Penumbra chain?"

거래 세부 정보를 받으세요:

Tell Claude: "Look up Penumbra transaction [HASH]"

DEX 상태 보기:

Tell Claude: "Show me the current Penumbra DEX state"

거버넌스 제안 목록:

Tell Claude: "List active Penumbra governance proposals"

개발

npm run watch : 개발을 위한 감시 모드
npm run inspector : 테스트를 위해 MCP 검사기를 실행합니다.
npm test : 테스트 모음 실행

환경 변수

노드 구성

PENUMBRA_NODE_URL : Penumbra 노드의 URL(기본값: https://rpc.penumbra.zone )
PENUMBRA_REQUEST_TIMEOUT : HTTP 요청 시간 초과(밀리초)(기본값: 30000)
PENUMBRA_REQUEST_RETRIES : 요청 재시도 횟수(기본값: 5)

체인 구성

PENUMBRA_NETWORK : 연결할 네트워크(기본값: 메인넷)
PENUMBRA_CHAIN_ID : 체인 ID(기본값: penumbra-1)
PENUMBRA_BLOCK_TIME : 블록 시간(밀리초)(기본값: 6000)
PENUMBRA_EPOCH_DURATION : 에포크당 블록 수(기본값: 100)

DEX 구성

PENUMBRA_DEX_BATCH_INTERVAL : 일괄 경매 간격(밀리초)(기본값: 60000)
PENUMBRA_DEX_MIN_LIQUIDITY : 최소 유동성 금액(기본값: 1000)
PENUMBRA_DEX_MAX_PRICE_IMPACT : 소수점 형태로 표현된 최대 가격 영향(기본값: 0.05)

거버넌스 구성

PENUMBRA_GOVERNANCE_VOTING_PERIOD : 투표 기간(밀리초) (기본값: 1209600000 - 14일)
PENUMBRA_GOVERNANCE_MIN_DEPOSIT : 제안 최소 입금 금액(기본값: 100000)

건축학

이 서버는 TypeScript를 사용하여 구축되었으며, 표준화된 도구 인터페이스를 위한 모델 컨텍스트 프로토콜(MCP)을 구현합니다. 현재 핵심 기능에 대한 모의 구현을 제공하고 있으며, Penumbra의 클라이언트 라이브러리 및 노드 API 엔드포인트와 직접 통합될 계획입니다.

개인정보 보호 고려 사항

모든 상호작용은 Penumbra의 개인 정보 보호 디자인을 존중합니다.

보호된 거래
프라이빗 스테이킹 운영
봉인 입찰 일괄 경매
익명의 거버넌스 투표

기여하다

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

특허

아이에스씨

Penumbra MCP Server