Apillon MCP Server

Servidor MCP de Apillon

Bienvenido al repositorio del Servidor MCP de Apillon. Este proyecto implementa un servidor que utiliza el Protocolo de Contexto de Modelos (MCP) para proporcionar módulos de funcionalidades de Almacenamiento, Alojamiento y NFT.

Introducción al Protocolo de Contexto de Modelos (MCP)

El Protocolo de Contexto de Modelos (MCP) es un protocolo abierto que estandariza cómo las aplicaciones proporcionan contexto a los Modelos de Lenguaje de Gran Escala (LLMs). Piensa en MCP como un puerto USB-C para aplicaciones de IA. Así como USB-C proporciona una forma estandarizada de conectar tus dispositivos a varios periféricos y accesorios, MCP proporciona una forma estandarizada de conectar modelos de IA a diferentes fuentes de datos y herramientas.

MCP te ayuda a construir agentes y flujos de trabajo complejos sobre LLMs. Los LLMs frecuentemente necesitan integrarse con datos y herramientas, y MCP proporciona:

• Una lista creciente de integraciones preconstruidas a las que tu LLM puede conectarse directamente.
• La flexibilidad para cambiar entre proveedores y vendedores de LLM.
• Mejores prácticas para asegurar tus datos dentro de tu infraestructura.

Para más información, visita la Introducción al Protocolo de Contexto de Modelos.

Resumen del Proyecto

Este proyecto es desarrollado por Apillon y proporciona una implementación de servidor para los siguientes módulos:

Módulo de Almacenamiento

El módulo de Almacenamiento proporciona capacidades integrales de gestión de archivos:

• Crear y gestionar buckets de almacenamiento
• Subir archivos y carpetas con soporte para estructuras de directorios
• Listar y gestionar objetos (archivos y carpetas) dentro de los buckets
• Generar enlaces IPFS para direccionamiento de contenido
• Gestionar registros IPNS para nombres persistentes
• Eliminar archivos y directorios
• Rastrear el estado de archivos y metadatos

Módulo de Alojamiento

El módulo de Alojamiento permite el despliegue de aplicaciones web:

• Crear y gestionar instancias de sitios web
• Subir archivos de sitios web desde carpetas locales o buffers
• Desplegar en entornos de staging y producción
• Monitorear el estado de los despliegues
• Listar y gestionar despliegues
• Soporte para múltiples entornos de despliegue

Módulo NFT

El módulo NFT proporciona una gestión integral de NFT:

• Crear colecciones NFT en varias cadenas (EVM, Substrate, Unique)
• Configurar parámetros de colección (nombre, símbolo, regalías, etc.)
• Acuñar NFTs a direcciones específicas
• Soporte para NFTs anidados (colecciones anidables)
• Quemar/revocar NFTs (para colecciones revocables)
• Transferir la propiedad de la colección
• Monitorear el estado de las transacciones
• Soporte para drops con parámetros configurables

Uso con Claude

Para usar este MCP con el LLM de Claude, sigue estos pasos:

1. Instala Claude para Desktop

2. Localiza el Archivo de Configuración de 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

3. Añade la Configuración

Copia la configuración de claude_desktop_config.json y ajústala con tus propios parámetros.

⚠️ Importante: Asegúrate de modificar las variables de entorno de la clave API y los directorios permitidos para el MCP del sistema de archivos.

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

4. Reinicia Claude para Desktop

Después de hacer estos cambios, reinicia Claude Desktop para que la configuración surta efecto. Ahora puedes pedirle a Claude que realice cualquiera de las acciones disponibles usando solo el chat de texto.

Desarrollo local

Requisitos previos

• Node.js 22 o superior
• npm 11 o superior
• TypeScript
• Clave y secreto de API de Apillon (se pueden generar en https://app.apillon.io)

Instalación

Clona el repositorio e instala las dependencias:

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

Modifica tu configuración local de 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>"
      }
    }
  }
}

Ejecutando el Servidor

El método preferido para probar tu servidor es usar Claude Desktop con la configuración anterior. Alternativamente, para iniciar el servidor localmente, usa el siguiente comando:

npm start

Compilando el Proyecto

Para compilar el proyecto, ejecuta:

npm run build

Contribuciones

Agradecemos las contribuciones al Servidor MCP de Apillon. Por favor, revisa los issues para cualquier tarea abierta o errores.

Licencia

Este proyecto está licenciado bajo la Licencia MIT.

Revisión MCP

Este servidor MCP está certificado por revisión MCP

Visita nuestra propia página de revisión MCP

Contacto

Para más información, visita el sitio web de Apillon o contacta a través de issues de GitHub.