Tinyman MCP

Tinyman MCP

Uma implementação do Model Context Protocol (MCP) para Tinyman na Algorand, construída pela GoPlausible.

Visão Geral

Este projeto fornece ferramentas e recursos MCP para interagir com o protocolo AMM da Tinyman na blockchain Algorand. Ele consiste em dois pacotes principais:

• @tinyman-mcp/server: Implementação do servidor MCP fornecendo ferramentas para operações da Tinyman, como swaps, provisão de liquidez, gerenciamento de pools e análises
• @tinyman-mcp/client: Implementação do cliente para conexões de carteira e assinatura de transações (Em andamento)

Recursos

O servidor MCP fornece as seguintes ferramentas:

Gerenciamento de Pools

• tinyman_get_pool: Recupera informações detalhadas sobre um pool específico
• tinyman_get_pool_analytics: Obtém análises e estatísticas de um pool
• tinyman_get_pool_creation_quote: Gera cotação para criar um novo pool

Operações de Negociação

• tinyman_get_swap_quote: Gera cotações para swaps de ativos com suporte para:
  • Swaps com valor de entrada fixo
  • Swaps com valor de saída fixo
  • Cálculos de slippage

Gerenciamento de Liquidez

• tinyman_get_liquidity_quote: Gera cotações para adicionar liquidez
  • Suporta depósitos de ativo único e duplo
  • Calcula tokens de pool esperados
• tinyman_get_remove_liquidity_quote: Gera cotações para remover liquidez
  • Suporta retiradas proporcionais e de ativo único
  • Calcula retornos esperados de ativos

Operações com Ativos

• tinyman_get_asset_optin_quote: Gera cotação para optar por um ativo
• tinyman_get_validator_optin_quote: Gera cotação para optar por um validador
• tinyman_get_validator_optout_quote: Gera cotação para sair de um validador

Todas as ferramentas suportam os protocolos Tinyman v1.1 e v2, sendo o v2 a versão padrão quando aplicável.

Instalação

Para instalar ou atualizar a implementação do Tinyman MCP, clone o repositório, instale as dependências e faça o build do projeto:

Primeiro verifique se a versão do node é 23.6.1 ou posterior:

node -v

Atualize para 23.6.1 ou posterior se necessário!

Em seguida, verifique se as pastas de contêiner do Claude ou Cursor possuem a pasta mcp-servers (se não existir, crie uma):

mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor 
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

Depois clone este repositório na pasta mcp-servers e instale as dependências:

cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor 
cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
# Clone the repository
git clone https://github.com/GoPlausible/tinyman-mcp.git
cd tinyman-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Edit the .env file to set your configurations

E pronto! Agora você pode abrir sua configuração MCP e adicionar o servidor como:

{
  "mcpServers": {
    "tinyman-mcp": {
      "command": "node",
      "args": [
        "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/tinyman-mcp/packages/server/dist/index.js"
     ],
      "env": {
        "ALGORAND_NETWORK": "mainnet",
        "ALGORAND_ALGOD_API": "https://mainnet-api.algonode.cloud/v2",
        "ALGORAND_ALGOD": "https://mainnet-api.algonode.cloud",
        "ALGORAND_ALGOD_PORT": "",
        "ALGORAND_TOKEN": "",
        "ALGORAND_AGENT_WALLET": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
        "ITEMS_PER_PAGE": "10"

      }
    }
  }
}

Certifique-se de alterar os caminhos para corresponder aos caminhos do seu sistema local.

Por exemplo, no MACOS e Claude, o caminho seria algo assim:

{
  "mcpServers": {
    "algorand-mcp": {
      "command": "node",
      "args": [
        " /Users/YOUR_USERNAME/Library/Application\ Support/Claude/mcp-servers/tinyman-mcp/packages/server/dist/index.js"
     ]
    }
  }
}

Estrutura do Projeto

packages/
  ├── client/         # Client implementation (WIP)
  └── server/         # MCP server implementation

Desenvolvimento

# Install dependencies
npm install

# Build all packages
npm run build

# Clean build artifacts
npm run clean

Licença

MIT