Penumbra MCP Server

Servidor MCP de Penumbra

Un servidor MCP que proporciona herramientas para interactuar con la blockchain de Penumbra. Este servidor permite interacciones que preservan la privacidad con las funciones principales de Penumbra, como consultas de transacciones, información del conjunto de validadores, estado de DEX y propuestas de gobernanza.

Características

Herramientas actuales

• get_validator_set : obtiene la información del conjunto de validadores actual
• get_chain_status : obtiene el estado actual de la cadena, incluida la altura del bloque y la identificación de la cadena
• get_transaction : Obtener detalles de una transacción específica
• get_dex_state : obtiene el estado actual de DEX, incluidos los resultados de la última subasta por lotes
• get_governance_proposals : Obtener propuestas de gobernanza activas

Funciones planificadas

• Envío de transacción
• Operaciones de staking privado
• Comercio DEX (subastas por lotes con ofertas selladas)
• Votación de gobernanza privada
• Gestión de la posición de liquidez

Instalación

Puede instalar el paquete a través de npm:

O usando hilo:

Configuración

Desarrollo local desde la fuente

1. Instalar dependencias:

2. Construir el servidor:

3. Ejecutar en modo de desarrollo:

Integración de escritorio de Claude

Para integrarse con el escritorio Claude, agregue la siguiente configuración a su archivo de configuración del escritorio Claude ( ~/Library/Application Support/Claude/claude_desktop_config.json ):

Reemplace /path/to/penumbra-mcp con la ruta real donde instaló el servidor.

Uso del servidor MCP

Una vez configurado, podrás interactuar con Penumbra a través de Claude utilizando las siguientes herramientas:

1. Conjunto de validadores de consultas:

2. Comprobar el estado de la cadena:

3. Obtener detalles de la transacción:

4. Ver el estado de DEX:

5. Lista de propuestas de gobernanza:

Desarrollo

• npm run watch : Modo de vigilancia para el desarrollo
• npm run inspector : ejecuta el inspector MCP para realizar pruebas
• npm test : Ejecutar conjunto de pruebas

Variables de entorno

Configuración del nodo

• PENUMBRA_NODE_URL : URL del nodo Penumbra (predeterminado: https://rpc.penumbra.zone )
• PENUMBRA_REQUEST_TIMEOUT : tiempo de espera de la solicitud HTTP en milisegundos (valor predeterminado: 30000)
• PENUMBRA_REQUEST_RETRIES : Número de reintentos de solicitud (predeterminado: 5)

Configuración de la cadena

• PENUMBRA_NETWORK : Red a la que conectarse (predeterminado: red principal)
• PENUMBRA_CHAIN_ID : ID de cadena (predeterminado: penumbra-1)
• PENUMBRA_BLOCK_TIME : Tiempo de bloque en milisegundos (predeterminado: 6000)
• PENUMBRA_EPOCH_DURATION : Número de bloques por época (predeterminado: 100)

Configuración de DEX

• PENUMBRA_DEX_BATCH_INTERVAL : Intervalo de subasta por lotes en milisegundos (valor predeterminado: 60000)
• PENUMBRA_DEX_MIN_LIQUIDITY : Monto mínimo de liquidez (predeterminado: 1000)
• PENUMBRA_DEX_MAX_PRICE_IMPACT : Impacto máximo del precio en decimal (predeterminado: 0,05)

Configuración de gobernanza

• PENUMBRA_GOVERNANCE_VOTING_PERIOD : Duración del período de votación en milisegundos (valor predeterminado: 1209600000 - 14 días)
• PENUMBRA_GOVERNANCE_MIN_DEPOSIT : Monto mínimo de depósito de propuesta (predeterminado: 100000)

Arquitectura

El servidor está desarrollado con TypeScript e implementa el Protocolo de Contexto de Modelo (MCP) para interfaces de herramientas estandarizadas. Actualmente ofrece implementaciones simuladas para la funcionalidad principal, con planes para integrarse directamente con las bibliotecas cliente de Penumbra y los endpoints de la API de nodo.

Consideraciones de privacidad

Todas las interacciones respetan el diseño de preservación de la privacidad de Penumbra:

• Transacciones protegidas
• Operaciones de staking privado
• Subastas por lotes con oferta sellada
• Votación anónima de gobernanza

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

ISC