Apillon MCP Server

Interaja com os módulos de Armazenamento, Hospedagem e NFT da Apillon.

GitHub
3

Documentação

Servidor MCP da Apillon

npm version

Bem-vindo ao repositório do Servidor MCP da Apillon. Este projeto implementa um servidor usando o Protocolo de Contexto de Modelo (MCP) para fornecer módulos de funcionalidades de Armazenamento, Hospedagem e NFT.

Introdução ao Protocolo de Contexto de Modelo (MCP)

O Protocolo de Contexto de Modelo (MCP) é um protocolo aberto que padroniza como aplicações fornecem contexto para Modelos de Linguagem de Grande Escala (LLMs). Pense no MCP como uma porta USB-C para aplicações de IA. Assim como o USB-C fornece uma maneira padronizada de conectar seus dispositivos a vários periféricos e acessórios, o MCP fornece uma maneira padronizada de conectar modelos de IA a diferentes fontes de dados e ferramentas.

O MCP ajuda você a construir agentes e fluxos de trabalho complexos sobre LLMs. Os LLMs frequentemente precisam se integrar a dados e ferramentas, e o MCP fornece:

  • Uma lista crescente de integrações pré-construídas às quais seu LLM pode se conectar diretamente.
  • A flexibilidade de alternar entre provedores e fornecedores de LLM.
  • Melhores práticas para proteger seus dados dentro da sua infraestrutura.

Para mais informações, visite a Introdução ao Protocolo de Contexto de Modelo.

Visão Geral do Projeto

Este projeto é desenvolvido pela Apillon e fornece uma implementação de servidor para os seguintes módulos:

Módulo de Armazenamento

O módulo de Armazenamento fornece capacidades abrangentes de gerenciamento de arquivos:

  • Criar e gerenciar buckets de armazenamento
  • Enviar arquivos e pastas com suporte para estruturas de diretórios
  • Listar e gerenciar objetos (arquivos e pastas) dentro dos buckets
  • Gerar links IPFS para endereçamento de conteúdo
  • Gerenciar registros IPNS para nomenclatura persistente
  • Excluir arquivos e diretórios
  • Rastrear status de arquivos e metadados

Módulo de Hospedagem

O módulo de Hospedagem permite a implantação de aplicações web:

  • Criar e gerenciar instâncias de sites
  • Enviar arquivos do site a partir de pastas locais ou buffers
  • Implantar em ambientes de staging e produção
  • Monitorar o status da implantação
  • Listar e gerenciar implantações
  • Suporte para múltiplos ambientes de implantação

Módulo NFT

O módulo NFT fornece gerenciamento abrangente de NFTs:

  • Criar coleções NFT em várias blockchains (EVM, Substrate, Unique)
  • Configurar parâmetros da coleção (nome, símbolo, royalties, etc.)
  • Cunhar NFTs para endereços específicos
  • Suporte para NFTs aninhados (coleções aninháveis)
  • Queimar/revogar NFTs (para coleções revogáveis)
  • Transferir propriedade da coleção
  • Monitorar o status das transações
  • Suporte para drops com parâmetros configuráveis

Usando com Claude

Para usar este MCP com o LLM Claude, siga estes passos:

  1. Instale o Claude para Desktop

  2. Localize o Arquivo de Configuração do Claude Desktop

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
  1. Adicione a Configuração

Copie a configuração de claude_desktop_config.json e ajuste-a com seus próprios parâmetros.

⚠️ Importante: Certifique-se de modificar as variáveis de ambiente da chave de API e os diretórios permitidos para o MCP de sistema de arquivos.

{
  "mcpServers": {
    "apillon-mcp-server": {
      "command": "npx",
      "args": ["-y", "@apillon/mcp-server"],
      "env": {
        "APILLON_API_KEY": "<APILLON_API_KEY>",
        "APILLON_API_SECRET": "<APILLON_API_SECRET>"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/your-username/Desktop"
      ]
    }
  }
}
  1. Reinicie o Claude para Desktop

Após fazer essas alterações, reinicie o Claude Desktop para que a configuração entre em vigor. Agora você pode solicitar ao Claude que execute qualquer uma das ações disponíveis usando apenas o chat de texto.

Desenvolvimento local

Pré-requisitos

  • Node.js 22 ou superior
  • npm 11 ou superior
  • TypeScript
  • Chave e segredo da API Apillon (podem ser gerados em https://app.apillon.io)

Instalação

Clone o repositório e instale as dependências:

git clone https://github.com/Apillon/mcp-server.git
cd mcp-server
npm install

Modifique sua configuração local do claude desktop:

{
  "mcpServers": {
    "apillon-mcp-server": {
      "command": "tsx",
      "args": ["/full/path/to/index.ts"],
      "env": {
        "APILLON_API_KEY": "<APILLON_API_KEY>",
        "APILLON_API_SECRET": "<APILLON_API_SECRET>"
      }
    }
  }
}

Executando o Servidor

O método preferido para testar seu servidor é usar o Claude Desktop com a configuração acima. Alternativamente, para iniciar o servidor localmente, use o seguinte comando:

npm start

Compilando o Projeto

Para compilar o projeto, execute:

npm run build

Contribuindo

Aceitamos contribuições para o Servidor MCP da Apillon. Por favor, verifique as issues para tarefas abertas ou bugs.

Licença

Este projeto é licenciado sob a Licença MIT.

Revisão MCP

Este servidor MCP é certificado pela revisão MCP

Visite nossa própria página de Revisão MCP

Contato

Para mais informações, visite o site da Apillon ou entre em contato via issues do GitHub.