BAMM

Servidor MCP BAMM

Visão Geral

O Servidor MCP BAMM permite que agentes de IA interajam com contratos do Borrow Automated Market Maker (BAMM) na blockchain Fraxtal. Este servidor fornece acesso abrangente a posições BAMM, operações de empréstimo, tomada de empréstimo e gerenciamento de garantias.

Ao implementar o Model Context Protocol (MCP), este servidor permite que Modelos de Linguagem de Grande Porte (LLMs) gerenciem posições BAMM, tomem empréstimos contra tokens LP e realizem outras operações relacionadas ao protocolo BAMM diretamente através de sua janela de contexto.

Recursos

• Gerenciamento de Posições: Visualize e gerencie suas posições BAMM ativas em todos os pools.
• Operações de Empréstimo: Empreste tokens LP Fraxswap para contratos BAMM para obter rendimento.
• Tomada de Empréstimo: Tome tokens emprestados contra sua garantia de posições BAMM.
• Gerenciamento de Garantias: Adicione ou remova garantias de suas posições BAMM.
• Análises de Pool: Acesse estatísticas de todos os pools BAMM.

Instalação

Usando npx (Recomendado)

Para usar este servidor sem instalá-lo globalmente:

npx @iqai/mcp-bamm

Compilar a partir do Código Fonte

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

Executando com um Cliente MCP

Adicione a seguinte configuração às configurações do seu cliente MCP (por exemplo, claude_desktop_config.json).

Configuração Mínima

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

Configuração Avançada (Compilação Local)

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

Configuração (Variáveis de Ambiente)

Variável	Obrigatória	Descrição	Padrão
WALLET_PRIVATE_KEY	Sim	Chave privada da carteira para assinar transações	-

Nota de Segurança: Manuseie sua chave privada com extremo cuidado. Certifique-se de que ela esteja armazenada com segurança e fornecida apenas a configurações confiáveis de cliente MCP.

Exemplos de Uso

Gerenciamento de Posições

• "Quais são minhas posições BAMM atuais?"
• "Mostre-me as estatísticas de todos os pools BAMM."

Empréstimo e Tomada de Empréstimo

• "Empreste 100 tokens LP para o BAMM no endereço 0x..."
• "Tome 50 FRAX emprestados da minha posição BAMM."
• "Pague 25 FRAX para minha posição BAMM."

Operações de Garantia

• "Adicione 100 FRAX como garantia à minha posição BAMM."
• "Remova 50 USDC de garantia da minha posição."
• "Retire meus tokens LP do BAMM."

Ferramentas MCP

ADD_COLLATERAL

Adicionar garantia à sua posição BAMM

Parâmetro	Tipo	Obrigatório	Descrição
bammAddress	string	Sim	O endereço do contrato BAMM
amount	string	Sim	A quantidade de garantia a adicionar
collateralToken	string		O endereço do token de garantia
collateralTokenSymbol	string		O símbolo do token de garantia (ex.: 'IQT')

BORROW

Tomar tokens emprestados de uma posição BAMM

Parâmetro	Tipo	Obrigatório	Descrição
bammAddress	string	Sim	O endereço do contrato BAMM
amount	string	Sim	A quantidade a tomar emprestada
borrowToken	string		O endereço do token a tomar emprestado
borrowTokenSymbol	string		O símbolo do token a tomar emprestado (ex.: 'IQT')

LEND

Emprestar tokens LP Fraxswap para um contrato BAMM

Parâmetro	Tipo	Obrigatório	Descrição
bammAddress	string	Sim	O endereço do contrato BAMM
amount	string	Sim	A quantidade de tokens LP a emprestar

REMOVE_COLLATERAL

Remover garantia da sua posição BAMM

Parâmetro	Tipo	Obrigatório	Descrição
bammAddress	string	Sim	O endereço do contrato BAMM
amount	string	Sim	A quantidade de garantia a remover
collateralToken	string		O endereço do token de garantia
collateralTokenSymbol	string		O símbolo do token de garantia (ex.: 'IQT')

REPAY

Pagar tokens emprestados a uma posição BAMM

Parâmetro	Tipo	Obrigatório	Descrição
bammAddress	string	Sim	O endereço do contrato BAMM
amount	string	Sim	A quantidade a pagar
borrowToken	string		O endereço do token a pagar
borrowTokenSymbol	string		O símbolo do token a pagar (ex.: 'IQT')

WITHDRAW

Retirar tokens LP de um contrato BAMM resgatando tokens BAMM

Parâmetro	Tipo	Obrigatório	Descrição
bammAddress	string	Sim	O endereço do contrato BAMM
amount	string	Sim	A quantidade de tokens BAMM a retirar

Desenvolvimento

Compilar o Projeto

pnpm run build

Modo de Desenvolvimento (Observar)

pnpm run watch

Linting e Formatação

pnpm run lint
pnpm run format

Estrutura do Projeto

• src/tools/: Definições de ferramentas individuais
• src/services/: Cliente de API e lógica de negócios
• src/lib/: Utilitários compartilhados
• src/index.ts: Ponto de entrada do servidor

Recursos

• Documentação BAMM
• Model Context Protocol (MCP)
• Rede Fraxtal

Aviso Legal

Este projeto interage com contratos inteligentes de blockchain e lida com transações de criptomoedas. Os usuários devem ter cautela, verificar todos os dados de forma independente e entender os riscos envolvidos nas operações DeFi.

Licença

MIT