BAMM

BAMM MCP Server

Resumen

El servidor BAMM MCP permite a los agentes de IA interactuar con los contratos de Borrow Automated Market Maker (BAMM) en la blockchain de Fraxtal. Este servidor proporciona acceso completo a las posiciones BAMM, operaciones de préstamo, endeudamiento y gestión de garantías.

Al implementar el Protocolo de Contexto de Modelo (MCP), este servidor permite que los Modelos de Lenguaje de Gran Tamaño (LLMs) gestionen posiciones BAMM, pidan prestado contra tokens LP y realicen otras operaciones relacionadas con el protocolo BAMM directamente a través de su ventana de contexto.

Características

• Gestión de posiciones: Ve y gestiona tus posiciones BAMM activas en todos los pools.
• Operaciones de préstamo: Presta tokens LP de Fraxswap a contratos BAMM para obtener rendimiento.
• Endeudamiento: Pide prestados tokens contra tu garantía de posiciones BAMM.
• Gestión de garantías: Agrega o elimina garantías de tus posiciones BAMM.
• Analíticas de pools: Accede a estadísticas de todos los pools BAMM.

Instalación

Usando npx (Recomendado)

Para usar este servidor sin instalarlo globalmente:

npx @iqai/mcp-bamm

Compilar desde el código fuente

git clone https://github.com/IQAIcom/mcp-bamm.git
cd mcp-bamm
pnpm install
pnpm run build

Ejecución con un cliente MCP

Agrega la siguiente configuración a los ajustes de tu cliente MCP (por ejemplo, claude_desktop_config.json).

Configuración mínima

{
  "mcpServers": {
    "bamm": {
      "command": "npx",
      "args": ["-y", "@iqai/mcp-bamm"],
      "env": {
        "WALLET_PRIVATE_KEY": "your_wallet_private_key_here"
      }
    }
  }
}

Configuración avanzada (compilación local)

{
  "mcpServers": {
    "bamm": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-bamm/dist/index.js"],
      "env": {
        "WALLET_PRIVATE_KEY": "your_wallet_private_key_here"
      }
    }
  }
}

Configuración (Variables de entorno)

Variable	Requerido	Descripción	Predeterminado
WALLET_PRIVATE_KEY	Sí	Clave privada de la billetera para firmar transacciones	-

Nota de seguridad: Maneja tu clave privada con extremo cuidado. Asegúrate de que esté almacenada de forma segura y solo se proporcione a configuraciones de cliente MCP de confianza.

Ejemplos de uso

Gestión de posiciones

• "¿Cuáles son mis posiciones BAMM actuales?"
• "Muéstrame las estadísticas de todos los pools de BAMM."

Préstamo y endeudamiento

• "Presta 100 tokens LP al BAMM en la dirección 0x..."
• "Pide prestados 50 FRAX de mi posición BAMM."
• "Reembolsa 25 FRAX a mi posición BAMM."

Operaciones de garantía

• "Agrega 100 FRAX como garantía a mi posición BAMM."
• "Elimina 50 USDC de garantía de mi posición."
• "Retira mis tokens LP del BAMM."

Herramientas MCP

ADD_COLLATERAL

Agrega garantía a tu posición BAMM

Parámetro	Tipo	Requerido	Descripción
bammAddress	string	Sí	La dirección del contrato BAMM
amount	string	Sí	La cantidad de garantía a agregar
collateralToken	string		La dirección del token de garantía
collateralTokenSymbol	string		El símbolo del token de garantía (por ejemplo, 'IQT')

BORROW

Pide prestados tokens de una posición BAMM

Parámetro	Tipo	Requerido	Descripción
bammAddress	string	Sí	La dirección del contrato BAMM
amount	string	Sí	La cantidad a pedir prestada
borrowToken	string		La dirección del token a pedir prestado
borrowTokenSymbol	string		El símbolo del token a pedir prestado (por ejemplo, 'IQT')

LEND

Presta tokens LP de Fraxswap a un contrato BAMM

Parámetro	Tipo	Requerido	Descripción
bammAddress	string	Sí	La dirección del contrato BAMM
amount	string	Sí	La cantidad de tokens LP a prestar

REMOVE_COLLATERAL

Elimina garantía de tu posición BAMM

Parámetro	Tipo	Requerido	Descripción
bammAddress	string	Sí	La dirección del contrato BAMM
amount	string	Sí	La cantidad de garantía a eliminar
collateralToken	string		La dirección del token de garantía
collateralTokenSymbol	string		El símbolo del token de garantía (por ejemplo, 'IQT')

REPAY

Reembolsa tokens prestados a una posición BAMM

Parámetro	Tipo	Requerido	Descripción
bammAddress	string	Sí	La dirección del contrato BAMM
amount	string	Sí	La cantidad a reembolsar
borrowToken	string		La dirección del token a reembolsar
borrowTokenSymbol	string		El símbolo del token a reembolsar (por ejemplo, 'IQT')

WITHDRAW

Retira tokens LP de un contrato BAMM canjeando tokens BAMM

Parámetro	Tipo	Requerido	Descripción
bammAddress	string	Sí	La dirección del contrato BAMM
amount	string	Sí	La cantidad de tokens BAMM a retirar

Desarrollo

Compilar el proyecto

pnpm run build

Modo de desarrollo (watch)

pnpm run watch

Linting y formateo

pnpm run lint
pnpm run format

Estructura del proyecto

• src/tools/: Definiciones de herramientas individuales
• src/services/: Cliente API y lógica de negocio
• src/lib/: Utilidades compartidas
• src/index.ts: Punto de entrada del servidor

Recursos

• Documentación de BAMM
• Model Context Protocol (MCP)
• Red Fraxtal

Descargo de responsabilidad

Este proyecto interactúa con contratos inteligentes de blockchain y maneja transacciones de criptomonedas. Los usuarios deben tener precaución, verificar todos los datos de forma independiente y comprender los riesgos involucrados en las operaciones DeFi.

Licencia

MIT