Tinyman MCP

Tinyman MCP

Una implementación del Model Context Protocol (MCP) para Tinyman en Algorand, creada por GoPlausible.

Resumen

Este proyecto proporciona herramientas y recursos MCP para interactuar con el protocolo AMM de Tinyman en la blockchain de Algorand. Consta de dos paquetes principales:

• @tinyman-mcp/server: Implementación del servidor MCP que proporciona herramientas para operaciones de Tinyman como swaps, provisión de liquidez, gestión de pools y análisis
• @tinyman-mcp/client: Implementación del cliente para conexiones de wallet y firma de transacciones (Trabajo en Progreso)

Características

El servidor MCP proporciona las siguientes herramientas:

Gestión de Pools

• tinyman_get_pool: Recuperar información detallada sobre un pool específico
• tinyman_get_pool_analytics: Obtener análisis y estadísticas de un pool
• tinyman_get_pool_creation_quote: Generar cotización para crear un nuevo pool

Operaciones de Trading

• tinyman_get_swap_quote: Generar cotizaciones para swaps de activos con soporte para:
  • Swaps con cantidad de entrada fija
  • Swaps con cantidad de salida fija
  • Cálculos de deslizamiento

Gestión de Liquidez

• tinyman_get_liquidity_quote: Generar cotizaciones para añadir liquidez
  • Soporta depósitos de activo único y dual
  • Calcula los tokens de pool esperados
• tinyman_get_remove_liquidity_quote: Generar cotizaciones para retirar liquidez
  • Soporta retiros proporcionales y de activo único
  • Calcula los retornos de activos esperados

Operaciones con Activos

• tinyman_get_asset_optin_quote: Generar cotización para optar por un activo
• tinyman_get_validator_optin_quote: Generar cotización para optar por un validador
• tinyman_get_validator_optout_quote: Generar cotización para optar por no participar en un validador

Todas las herramientas soportan los protocolos Tinyman v1.1 y v2, siendo v2 la versión predeterminada cuando corresponde.

Instalación

Para instalar o actualizar la implementación de Tinyman MCP, clona el repositorio, instala las dependencias y compila el proyecto:

Primero verifica que la versión de node sea 23.6.1 o posterior:

node -v

¡Actualiza a 23.6.1 o posterior si es necesario!

Luego verifica que las carpetas del contenedor de Claude o Cursor tengan la carpeta mcp-servers (si no existe, créala):

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

Después clona este repositorio dentro de la carpeta mcp-servers e instala las dependencias:

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

¡Y listo! Ahora puedes abrir tu configuración de MCP y añadir el servidor de la siguiente manera:

{
  "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"

      }
    }
  }
}

Asegúrate de cambiar las rutas para que coincidan con las rutas de tu sistema local.

Por ejemplo, en MACOS y Claude, la ruta sería algo así:

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

Estructura del Proyecto

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

Desarrollo

# Install dependencies
npm install

# Build all packages
npm run build

# Clean build artifacts
npm run clean

Licencia

MIT