Divvi MCP Server

Integra automáticamente el SDK de referidos de Divvi en aplicaciones blockchain de JavaScript y TypeScript.

Documentación

Divvi MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona a los asistentes de IA herramientas para trabajar con el ecosistema Divvi. Actualmente se centra en la integración automática del @divvi/referral-sdk en aplicaciones blockchain de JavaScript/TypeScript, con más funcionalidades relacionadas con Divvi planificadas para futuras versiones.

Resumen

Integrar el seguimiento de referidos en aplicaciones blockchain normalmente requiere comprender la documentación del SDK, modificar los flujos de transacciones y mantener el código de integración a medida que los protocolos evolucionan. Este servidor MCP elimina esa complejidad convirtiendo a cualquier asistente de IA en un experto en integración de Divvi que puede implementar automáticamente el seguimiento de referidos siguiendo las mejores prácticas actuales.

Compatible con cualquier aplicación blockchain de JavaScript/TypeScript, incluyendo:

Frameworks de frontend: React, Next.js, Vue, Angular, Svelte, JavaScript vanilla
Aplicaciones de backend: Node.js, Express, Fastify, funciones serverless
Frameworks full-stack: Next.js, Nuxt, SvelteKit, Remix
Escritorio/móvil: Electron, React Native, Ionic
Cualquier aplicación JS/TS que realice transacciones blockchain

El servidor actualmente proporciona una herramienta MCP (integrate_divvi_referral_sdk) que:

📖 Guía a los agentes de IA para leer la documentación oficial más reciente del SDK de Divvi
🔍 Instruye el análisis del proyecto para comprender la estructura de la aplicación objetivo
🔧 Proporciona parámetros de integración (dirección del consumidor y campañas del proveedor)
✅ Garantiza una implementación adecuada siguiendo los patrones oficiales y las mejores prácticas

Uso

⚠️ Requisitos previos: Antes de usar esta herramienta, necesitas instalar y configurar el servidor MCP. Consulta la sección Instalación a continuación.

Integración simple

La forma más fácil de usar esto es simplemente preguntar a tu asistente de IA:

"Integrate this dapp with Divvi"

Tu asistente de IA te guiará para proporcionar la configuración necesaria (la dirección de tu dapp de Divvi y las direcciones de campaña) y manejará todo el proceso de integración.

Integración detallada

Para un control más específico, puedes proporcionar los parámetros exactos:

"Integrate my dapp with Divvi using consumer address 0x1234..."

El asistente de IA:

Leerá la documentación más reciente del SDK de Divvi
Analizará la estructura de tu proyecto
Instalará el SDK si es necesario
Modificará tus transacciones blockchain para incluir el seguimiento de referidos
Añadirá el envío de referidos después de las transacciones

Información requerida

Para completar la integración, necesitarás:

Dirección del consumidor: La dirección de tu wallet de dapp de Divvi (utilizada para registrarte como builder en Divvi)

Ejemplo de llamada a la herramienta

// The AI assistant will call this internally
integrate_divvi_referral_sdk({
  consumerAddress: '0x1234567890123456789012345678901234567890',
})

Características principales

Siempre actualizado: Instruye a los agentes de IA para que lean la documentación directamente del repositorio oficial
Compatibilidad universal: Funciona con React, Vue, Angular, Node.js, JavaScript vanilla y cualquier framework de JavaScript/TypeScript
Independiente de la librería blockchain: Soporta viem, ethers, wagmi y otras librerías Web3
No prescriptivo: Proporciona orientación mientras permite que los agentes de IA usen sus propias capacidades de forma inteligente
A prueba de futuro: Las instrucciones se adaptan a medida que el SDK de Divvi evoluciona
Extensible: Diseñado para soportar herramientas y funcionalidades adicionales del ecosistema Divvi

Nota técnica: Esta integración se implementa como una "herramienta" MCP en lugar de un tipo "prompt". Aunque la especificación MCP incluye un tipo de prompt que sería semánticamente más apropiado para este caso de uso, elegimos la implementación de herramienta para una mayor compatibilidad, ya que Cursor actualmente no soporta prompts MCP.

Instalación

Requisitos previos

Node.js 22+
Un asistente de IA compatible con MCP (Claude Desktop, Cursor, Copilot, etc.)

Configuración rápida (recomendada)

La forma más fácil de usar el servidor MCP de Divvi es a través de npm:

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "divvi-mcp": {
      "command": "npx",
      "args": ["-y", "@divvi/mcp-server"],
      "env": {}
    }
  }
}

Cursor

Cursor soporta servidores MCP a través de su configuración. Añade la configuración del servidor:

Abre la configuración de Cursor (Cmd/Ctrl + ,)
Navega a "Features" → "Model Context Protocol"
Añade un nuevo servidor MCP con:
- Nombre: divvi-mcp
- Comando: npx
- Argumentos: ["-y", "@divvi/mcp-server"]

Alternativamente, si Cursor utiliza un archivo de configuración, añade:

{
  "mcpServers": {
    "divvi-mcp": {
      "command": "npx",
      "args": ["-y", "@divvi/mcp-server"]
    }
  }
}

Otros clientes MCP

Configura según la documentación de tu cliente MCP, utilizando:

Comando: npx
Argumentos: ["-y", "@divvi/mcp-server"]

Configuración de desarrollo local

Para desarrollo o si prefieres compilar desde el código fuente:

Clona el repositorio:

git clone https://github.com/divvi-xyz/divvi-mcp.git
cd divvi-mcp

Instala las dependencias:
```
yarn install
```
Compila el servidor:
```
yarn build
```
Configura tu asistente de IA para que apunte a la compilación local:

Usa node como comando y ["/path/to/divvi-mcp/dist/index.js"] como argumentos en la configuración de tu cliente MCP.

Cómo funciona

1. Integración basada en documentación

La herramienta instruye a los agentes de IA para que lean la documentación oficial del SDK desde: https://raw.githubusercontent.com/divvi-xyz/divvi-referral-sdk/refs/heads/main/README.md

Esto garantiza que la integración siempre siga los patrones y ejemplos más recientes.

2. Análisis del proyecto

Los agentes de IA analizan el proyecto objetivo para comprender:

Gestor de paquetes (npm/yarn)
Framework de JavaScript/TypeScript utilizado
Librerías blockchain (viem, ethers, wagmi)
Patrones de transacciones existentes
Enfoque de gestión de cuentas

3. Integración del SDK

Siguiendo la documentación oficial, los agentes de IA implementan:

Instalación del SDK
Declaraciones de importación
Modificaciones de transacciones (añadiendo etiquetas de referido)
Envío de referidos después de las transacciones
Manejo adecuado de errores

4. Validación

La integración garantiza:

Todas las transacciones blockchain incluyen seguimiento de referidos
Los fallos de referidos no rompen los flujos de transacciones existentes
El código sigue las convenciones del proyecto
La integración utiliza las direcciones proporcionadas correctamente

Desarrollo

Desarrollo local

# Start in development mode
yarn dev

# Run tests
yarn test

# Type checking
yarn typecheck

# Linting
yarn lint

# Format code
yarn format

Estructura del proyecto

src/
├── index.ts          # Main MCP server implementation
├── index.test.ts     # Unit tests
└── ...

scripts/              # Build and utility scripts
dist/                 # Compiled output

Contribuciones

Haz un fork del repositorio
Crea una rama de funcionalidad: git checkout -b feature/my-feature
Realiza tus cambios siguiendo el estilo de código existente
Añade pruebas para la nueva funcionalidad
Ejecuta la suite de pruebas: yarn test
Envía una solicitud de pull

Referencia de la API

Herramientas actuales

Herramienta: `integrate_divvi_referral_sdk`

Proporciona instrucciones para integrar el @divvi/referral-sdk en un proyecto.

Parámetros

Parámetro	Tipo	Requerido	Descripción
`consumerAddress`	string	Sí	La dirección de tu wallet de dapp de Divvi (registro de builder)

Devuelve

Instrucciones completas de integración que guían a los agentes de IA a través de:

Lectura de la documentación oficial
Análisis de la estructura del proyecto
Implementación de la integración
Validación del resultado

Herramientas futuras

Se planean herramientas adicionales para el ecosistema Divvi en futuras versiones. Estas pueden incluir:

Integración de datos: Ayudas para el seguimiento del rendimiento y métricas de referidos
Interacción con el protocolo: Interacción directa con los contratos del protocolo Divvi
Gestión de campañas: Herramientas para crear y gestionar campañas de referidos

¡Mantente atento a las actualizaciones mientras expandimos las capacidades del servidor!

Proyectos relacionados

@divvi/referral-sdk: El SDK TypeScript principal para la integración con Divvi
Protocolo Divvi: Los repositorios principales del ecosistema Divvi

Soporte

Documentación: Documentación del SDK de Divvi
Problemas: Problemas de GitHub
Discusiones: Discusiones de GitHub

Licencia

Este proyecto está licenciado bajo la Apache License 2.0 - consulta el archivo LICENSE para más detalles.

Hecho con ❤️ para el ecosistema Divvi

Divvi MCP Server

Documentación

Divvi MCP Server

Resumen

Uso

Integración simple

Integración detallada

Información requerida

Ejemplo de llamada a la herramienta

Características principales

Instalación

Requisitos previos

Configuración rápida (recomendada)

Claude Desktop

Cursor

Otros clientes MCP

Configuración de desarrollo local

Cómo funciona

1. Integración basada en documentación

2. Análisis del proyecto

3. Integración del SDK

4. Validación

Desarrollo

Desarrollo local

Estructura del proyecto

Contribuciones

Referencia de la API

Herramientas actuales

Herramienta: integrate_divvi_referral_sdk

Parámetros

Devuelve

Herramientas futuras

Proyectos relacionados

Soporte

Licencia

Herramienta: `integrate_divvi_referral_sdk`