AMOCA (Agente Autónomo de Mérito en Cadena)

Este repositorio demuestra una implementación de un Agente Autónomo de Mérito en Cadena (AMOCA) para el desarrollo de Solana, construido sobre el Protocolo de Contexto de Modelo (MCP).

Tabla de contenido

AMOCA (Agente Autónomo de Mérito en Cadena)

¿Qué es AMOCA?

AMOCA (Agente Autónomo de Mérito en Cadena) es un agente inteligente que proporciona capacidades mejoradas para el desarrollo de la blockchain de Solana mediante una interfaz estandarizada. Esta implementación muestra:

Métodos RPC completos para Solana:
- Operaciones básicas de cuenta (getBalance, getAccountInfo, getTransaction)
- Cálculos de almacenamiento en cadena (getMinimumBalanceForRentExemption)
- Operaciones de billetera (createWallet, importWallet)
Capacidades de comercio DeFi:
- Comprobación del saldo de tokens (tokens individuales y análisis completo de la cartera)
- Visualización de la distribución del valor del token con histogramas basados en USD
- Seguimiento del valor de la cartera con datos de precios de la API de Jupiter
- Integración de la API de Jupiter para intercambios de tokens
- Recuperación de cotizaciones y ejecución de swaps
Flujos de trabajo autónomos útiles para el desarrollo de Solana:
- Indicaciones para el análisis de transacciones (diagnóstico de fallas, desglose de costos)
- Cálculos de costos de almacenamiento
- Acceso a la documentación para la instalación y los clústeres de Solana
Validación y verificación basada en méritos de las operaciones en cadena

Características

Herramientas Solana RPC : consulte información de cuentas, verifique saldos y analice transacciones
Gestión de billeteras : crear e importar billeteras Solana
Herramientas de trading : Realizar intercambios de tokens, consultar precios de tokens y analizar carteras.
Integración de API de Helius : aproveche las potentes API de Helius para un mejor acceso a los datos de Solana

Protocolo de Contexto del Modelo Solana (MCP)

Este repositorio demuestra una implementación simple de un servidor de Protocolo de Contexto de Modelo (MCP) para el desarrollo de Solana.

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es una interfaz estandarizada para que los modelos de IA interactúen con herramientas y recursos. Esta demostración muestra una implementación sencilla de servidor MCP que proporciona:

Métodos RPC básicos para Solana (getBalance, getAccountInfo, getTransaction)
Algunas indicaciones útiles para el desarrollo de Solana

Prerrequisitos

Node.js (se recomienda v16 o superior)
Gestor de paquetes pnpm (v9.10.0 o compatible)
Solana CLI (opcional pero recomendado)

Instalación

Clonar este repositorio e instalar las dependencias:

git clone https://github.com/manolaz/amoca-solana-mcp-server.git
cd solana-dev-mcp
pnpm install

Para ejecutar este servidor en el inspector MCP, utilice:

npx @modelcontextprotocol/inspector ts-node index.ts

Empezando

Configurar variables de entorno : cree un archivo .env basado en la plantilla .env.example con sus claves API.

cp .env.example .env
# Edit .env with your API keys

Explora el código : La implementación principal está en index.ts , que configura un servidor MCP con herramientas de búsqueda simples y algunos avisos.
Modificar el servidor : puedes ampliar el servidor agregando más herramientas, recursos y avisos.
Pruebe su implementación : ejecute el conjunto de pruebas para asegurarse de que todo funcione correctamente.

pnpm test

Ejemplo de uso

Esta sección explica cómo usar el servidor Solana MCP en Claude . Siga los mismos pasos para usar el servidor Solana MCP en Windsurf y Cursor .

Generar el archivo de configuración

Para usar este servidor Solana MCP, necesita generar un archivo de configuración que Claude pueda usar para conectarse al servidor. Ejecute uno de los siguientes comandos para generar el archivo de configuración:

pnpm generate-config si tiene ts-node instalado globalmente
pnpm build && pnpm generate-config:js si no tiene ts-node instalado globalmente

Esto imprimirá una configuración JSON con el siguiente contenido:

Si tienes ts-node :

{
  "mcpServers": {
    "solana-dev": {
      "command": "ts-node",
      "args": ["<full-path-to-repo>/index.ts"]
    }
  }
}

Si no tiene ts-node instalado globalmente:

{
  "mcpServers": {
    "solana-dev": {
      "command": "node",
      "args": ["<full-path-to-repo>/dist/index.js"]
    }
  }
}

Usando AMOCA con Claude

Estructura del proyecto

index.ts - Implementación del servidor principal
package.json - Dependencias y metadatos del proyecto
tsconfig.json - Configuración de TypeScript

Ideas para ampliar el MCP para el desarrollo de Solana

Esta implementación del servidor MCP proporciona una base que puede ampliar o bifurcar para sus propias necesidades de desarrollo con Solana. Aquí tiene algunas ideas para empezar:

Ideas para la ampliación

Estimador de Tarifas de Prioridad : Agregue una herramienta que calcule las tarifas de prioridad óptimas para las transacciones de Solana según la actividad reciente de la red. Esto podría ayudar a los usuarios a optimizar los costos de las transacciones y garantizar un procesamiento oportuno.
Depurador de Solana Verify : crea una herramienta que ayude a depurar problemas con solana-verify al proporcionar información más detallada sobre el proceso de verificación.
Inspector de Solana Security.txt : crea una herramienta que extrae y muestra la información del archivo security.txt para un programa Solana determinado, lo que facilita el contacto con los mantenedores del programa por inquietudes de seguridad.
Asistente de escuadrones para la implementación de programas : cree una herramienta que automatice el proceso de implementación y actualización de programas Solana, lo que facilita la administración del estado del programa en múltiples entornos.
Explicador de errores de Anchor : desarrolle una herramienta que tome un código de error y busque el mensaje de error legible por humanos correspondiente en la base de datos de códigos de error de Anchor.
Avisos mejorados : Amplía las capacidades de avisos del servidor para ofrecer sugerencias contextuales para las tareas de desarrollo de Solana. Por ejemplo, añade avisos para patrones de transacciones comunes, creación de cuentas u operaciones con tokens.
Generador de transacciones : crea herramientas que ayuden a construir transacciones complejas con múltiples instrucciones, lo que facilita la interacción con varios programas de Solana.
Puntos finales de RPC personalizados : permiten la configuración de puntos finales de RPC personalizados, incluido el soporte para proveedores de RPC privados o validadores locales.
Asistentes de implementación de programas : cree herramientas que simplifiquen el proceso de implementación y actualización de programas de Solana.
Explorador de Cuentas y Transacciones : Agregue una herramienta que toma el ID de una cuenta o transacción y muestra el contenido en un formato legible, similar a la vista de un explorador. Esto podría ser útil para inspeccionar los datos de las transacciones o el estado de la cuenta sin necesidad de decodificar manualmente los datos.
Documentación de Solana, Anchor y Protocolo : Agregue recursos que carguen la documentación de Solana, Anchor y Protocolo directamente en el editor de MCP, facilitando el acceso a la información relevante sin necesidad de salir del editor. Esto podría implementarse extrayendo la documentación de los repositorios correspondientes y sirviéndola como recursos desde el servidor de MCP.

Cómo contribuir

Si has creado una extensión que podría ser útil para otros, considera enviar una solicitud de incorporación de cambios a este repositorio. Asegúrate de seguir estas pautas:

Mantenga su código bien documentado
Incluir pruebas para nuevas funcionalidades
Seguir el estilo de código existente
Actualice el README con información sobre su incorporación

Herramientas API de Helius

Este proyecto integra varios puntos finales de la API de Helius para un potente acceso a los datos de Solana:

API del estándar de activos digitales (DAS)

Herramienta	Descripción
`getAssetsByOwner`	Obtenga NFT propiedad de una dirección específica
`getAsset`	Obtenga información detallada sobre un NFT específico por su ID
`getAssetsByGroup`	Obtener activos que pertenecen a un grupo específico (como una colección)
`searchAssets`	Búsqueda de activos mediante parámetros de consulta complejos
`getAssetProof`	Obtenga la prueba de Merkle para un NFT comprimido
`getAssetsByCreator`	Obtener activos creados por una dirección de creador específica
`getAssetsByAuthority`	Obtener activos actualizando la dirección de la autoridad
`getNftEditions`	Consigue todas las ediciones de una edición maestra NFT

API de colección y menta

Herramienta	Descripción
`getMintlist`	Obtener lista de menta para una colección

Gestión de webhooks

Herramienta	Descripción
`getAllWebhooks`	Obtenga todos los webhooks para su clave API de Helius
`getWebhookByID`	Obtener detalles del webhook por ID del webhook
`createWebhook`	Crear un nuevo webhook para monitorear la actividad de direcciones
`createCollectionWebhook`	Crea un webhook para monitorear colecciones de NFT
`deleteWebhook`	Eliminar un webhook por su ID

Herramientas de red y utilidades

Herramienta	Descripción
`getCurrentTPS`	Obtenga las transacciones actuales por segundo en Solana
`getTokenHolders`	Obtener los titulares de un token específico por dirección de acuñación
`getPriorityFeeEstimate`	Obtenga tarifas de prioridad estimadas para transacciones
`getStakeAccounts`	Obtener cuentas de participación por la dirección de su propietario
`getComputeUnits`	Simular una transacción para obtener el total de unidades de cómputo consumidas

Avisos mejorados

El servidor incluye indicaciones especializadas para tareas comunes relacionadas con Helius:

Inmediato	Descripción
`collection-analysis`	Obtenga un análisis detallado de una colección de NFT
`monitor-nft-collection`	Configurar un webhook para monitorear la actividad de recolección de NFT
`network-status`	Obtenga información sobre el estado de la red de Solana

Ejemplos de uso

Obtenga NFT propiedad de una dirección

const response = await server.tools.getAssetsByOwner({
  ownerAddress: "GoodboiNft5iFNhbgKkf1RX2VdMqKvt5xYxyVh3zf9okx",
});

Analizar una colección de NFT

const response = await server.prompts["collection-analysis"]({
  collectionAddress: "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w",
});

Supervisar el estado de la red

const response = await server.prompts["network-status"]({});

Licencia

Instituto Tecnológico de Massachusetts (MIT)

AMOCA Solana MCP Server

Integrations