Divvi MCP Server

Integre automaticamente o SDK de referência Divvi em aplicações blockchain JavaScript e TypeScript.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Divvi

Um servidor Model Context Protocol (MCP) que fornece a assistentes de IA ferramentas para trabalhar com o ecossistema Divvi. Atualmente foca na integração automática do @divvi/referral-sdk em aplicações blockchain JavaScript/TypeScript, com mais funcionalidades relacionadas ao Divvi planejadas para lançamentos futuros.

Visão Geral

Integrar rastreamento de indicações em aplicações blockchain normalmente exige entender a documentação do SDK, modificar fluxos de transações e manter o código de integração conforme os protocolos evoluem. Este servidor MCP elimina essa complexidade transformando qualquer assistente de IA em um especialista em integração Divvi que pode implementar automaticamente o rastreamento de indicações seguindo as melhores práticas atuais.

Compatível com qualquer aplicação blockchain JavaScript/TypeScript, incluindo:

  • Frameworks frontend: React, Next.js, Vue, Angular, Svelte, JavaScript puro
  • Aplicações backend: Node.js, Express, Fastify, funções serverless
  • Frameworks full-stack: Next.js, Nuxt, SvelteKit, Remix
  • Desktop/mobile: Electron, React Native, Ionic
  • Qualquer aplicação JS/TS que faça transações blockchain

O servidor atualmente fornece uma ferramenta MCP (integrate_divvi_referral_sdk) que:

  1. 📖 Orienta agentes de IA a ler a documentação oficial mais recente do SDK Divvi
  2. 🔍 Instrui a análise do projeto para entender a estrutura da aplicação alvo
  3. 🔧 Fornece parâmetros de integração (endereço do consumidor e campanhas do provedor)
  4. ✅ Garante implementação adequada seguindo padrões oficiais e melhores práticas

Uso

⚠️ Pré-requisitos: Antes de usar esta ferramenta, você precisa instalar e configurar o servidor MCP. Veja a seção Instalação abaixo.

Integração Simples

A maneira mais fácil de usar isto é simplesmente perguntar ao seu assistente de IA:

"Integrate this dapp with Divvi"

Seu assistente de IA irá guiá-lo no fornecimento da configuração necessária (seu endereço dapp Divvi e endereços de campanha) e lidar com todo o processo de integração.

Integração Detalhada

Para um controle mais específico, você pode fornecer os parâmetros exatos:

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

O assistente de IA irá:

  1. Ler a documentação mais recente do SDK Divvi
  2. Analisar a estrutura do seu projeto
  3. Instalar o SDK se necessário
  4. Modificar suas transações blockchain para incluir rastreamento de indicações
  5. Adicionar envio de indicações após as transações

Informações Necessárias

Para completar a integração, você precisará de:

  • Endereço do Consumidor: O endereço da sua carteira dapp Divvi (usado para registrar-se como construtor no Divvi)

Exemplo de Chamada de Ferramenta

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

Principais Recursos

  • Sempre atualizado: Instrui agentes de IA a ler a documentação diretamente do repositório oficial
  • Compatibilidade universal: Funciona com React, Vue, Angular, Node.js, JS puro e qualquer framework JavaScript/TypeScript
  • Agnóstico a bibliotecas blockchain: Suporta viem, ethers, wagmi e outras bibliotecas Web3
  • Não prescritivo: Fornece orientação enquanto permite que agentes de IA usem suas próprias capacidades de forma inteligente
  • À prova do futuro: As instruções se adaptam conforme o SDK Divvi evolui
  • Extensível: Projetado para suportar ferramentas e funcionalidades adicionais do ecossistema Divvi

Nota Técnica: Esta integração é implementada como uma "ferramenta" MCP em vez de um tipo "prompt". Embora a especificação MCP inclua um tipo prompt que seria semanticamente mais apropriado para este caso de uso, escolhemos a implementação de ferramenta para maior compatibilidade, já que o Cursor atualmente não suporta prompts MCP.

Instalação

Pré-requisitos

  • Node.js 22+
  • Um assistente de IA compatível com MCP (Claude Desktop, Cursor, Copilot, etc.)

Configuração Rápida (Recomendado)

A maneira mais fácil de usar o servidor MCP Divvi é via npm:

Claude Desktop

Adicione ao seu claude_desktop_config.json:

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

Cursor

O Cursor suporta servidores MCP através de suas configurações. Adicione a configuração do servidor:

  1. Abra as Configurações do Cursor (Cmd/Ctrl + ,)
  2. Navegue até "Features" → "Model Context Protocol"
  3. Adicione um novo servidor MCP com:
    • Nome: divvi-mcp
    • Comando: npx
    • Args: ["-y", "@divvi/mcp-server"]

Alternativamente, se o Cursor usar um arquivo de configuração, adicione:

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

Outros Clientes MCP

Configure de acordo com a documentação do seu cliente MCP, usando:

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

Configuração de Desenvolvimento Local

Para desenvolvimento ou se preferir compilar a partir do código-fonte:

  1. Clone o repositório:

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

  2. Instale as dependências:

    yarn install

  3. Compile o servidor:

    yarn build

  4. Configure seu assistente de IA para apontar para a compilação local:

    Use node como comando e ["/path/to/divvi-mcp/dist/index.js"] como args na configuração do seu cliente MCP.

Como Funciona

1. Integração Orientada por Documentação

A ferramenta instrui agentes de IA a ler a documentação oficial do SDK em: https://raw.githubusercontent.com/divvi-xyz/divvi-referral-sdk/refs/heads/main/README.md

Isso garante que a integração sempre siga os padrões e exemplos mais recentes.

2. Análise do Projeto

Agentes de IA analisam o projeto alvo para entender:

  • Gerenciador de pacotes (npm/yarn)
  • Framework JavaScript/TypeScript em uso
  • Bibliotecas blockchain (viem, ethers, wagmi)
  • Padrões de transação existentes
  • Abordagem de gerenciamento de contas

3. Integração do SDK

Seguindo a documentação oficial, agentes de IA implementam:

  • Instalação do SDK
  • Declarações de importação
  • Modificações de transação (adicionando tags de indicação)
  • Envio de indicações após transações
  • Tratamento adequado de erros

4. Validação

A integração garante:

  • Todas as transações blockchain incluem rastreamento de indicações
  • Falhas de indicação não quebram fluxos de transação existentes
  • O código segue as convenções do projeto
  • A integração usa os endereços fornecidos corretamente

Desenvolvimento

Desenvolvimento Local

# Start in development mode
yarn dev

# Run tests
yarn test

# Type checking
yarn typecheck

# Linting
yarn lint

# Format code
yarn format

Estrutura do Projeto

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

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

Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade: git checkout -b feature/my-feature
  3. Faça suas alterações seguindo o estilo de código existente
  4. Adicione testes para novas funcionalidades
  5. Execute a suíte de testes: yarn test
  6. Envie um pull request

Referência da API

Ferramentas Atuais

Ferramenta: integrate_divvi_referral_sdk

Fornece instruções para integrar o @divvi/referral-sdk em um projeto.

Parâmetros

ParâmetroTipoObrigatórioDescrição
consumerAddressstringSimEndereço da sua carteira dapp Divvi (registro de construtor)

Retornos

Instruções abrangentes de integração que orientam agentes de IA através de:

  • Leitura da documentação oficial
  • Análise da estrutura do projeto
  • Implementação da integração
  • Validação do resultado

Ferramentas Futuras

Ferramentas adicionais para o ecossistema Divvi estão planejadas para lançamentos futuros. Elas podem incluir:

  • Integração de dados: Auxiliares para rastrear desempenho e métricas de indicações
  • Interação com protocolo: Interação direta com contratos do protocolo Divvi
  • Gerenciamento de campanhas: Ferramentas para criar e gerenciar campanhas de indicação

Fique atento para atualizações enquanto expandimos as capacidades do servidor!

Projetos Relacionados

Suporte

Licença

Este projeto é licenciado sob a Apache License 2.0 - veja o arquivo LICENSE para detalhes.

Feito com ❤️ para o ecossistema Divvi