Servidor POI MCP

Un servidor de Protocolo de Contexto de Modelo para procesar archivos y preparar transacciones de blockchain. Este servidor se puede instalar en Claude Desktop y proporciona una herramienta para procesar archivos y prepararlos para transacciones de blockchain.

https://github.com/user-attachments/assets/6b2fbd68-4eca-4130-9594-d6720508e9c8

Configuración

Clonar este repositorio
Instalar dependencias:
```
npm install
```
Construir el servidor:
```
npm run build
```

Related MCP server: Trivy

Variables de entorno

API_TOKEN : Tu token de API para la autenticación con la API PoI. Puedes solicitar un nuevo token en el servidor de Discord de Molecule: https://discord.gg/k4ER7vZcj8

Uso

El servidor proporciona una herramienta llamada create_proof_of_invention_request que acepta una ruta de archivo y devuelve datos de transacciones preparados, aptos para la ejecución en blockchain. Estos datos pueden ser reutilizados por su herramienta preferida para firmar y enviar transacciones. El contenido binario debe ser proporcionado por el cliente MCP (por ejemplo, Claude Desktop o Cursor).

https://docs.molecule.to/documentation/proof-of-invention-poi/api-access-beta

Añadiendo a Claude Desktop

"poi": {
      "command": "npx",
      "args": ["mcp-poi"],
      "env": {
        "API_TOKEN": "the api token"
      }
    }

Funciona bien con otros servidores MCP

Nuestra configuración completa de escritorio de Claude se ve así:

{
  "mcpServers": {
    "mcp-cryptowallet-evm": {
      "command": "npx",
      "args": ["@mcp-dockmaster/mcp-cryptowallet-evm"],
      "env": {
        "PRIVATE_KEY": ""
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/stadolf/Downloads",
        "/Users/stadolf/Documents"
      ]
    },
    "poi": {
      "command": "npx",
      "args": ["-y", "mcp-poi"],
      "env": {
        "API_TOKEN": ""
      }
    }
  }
}

Indicaciones

| Crear un hash de poi a partir del archivo "idea.md" en mi carpeta Documentos... | Enviar una transacción Eth con el hash de poi a la dirección del poi en la cadena de bloques base.

Esquema de herramientas

Aporte:

{
  filepath: string; // A path of a binary
}

Producción:

{
  transaction_request: {
    to: string,      // a PoI anchoring address (usually starts with 0x1dea)
    data: string,    // the merkle root hash that represents the PoI
    value: string,   // 0
  }
}

Ejecución del servidor

npm start

Desarrollo

Para desarrollo con reconstrucción automática:

npm run dev

Manejo de errores

El servidor incluye un manejo robusto de errores para:

Variables de entorno faltantes
Contenido de archivo no válido
Errores de comunicación de la API
Formatos de respuesta no válidos

Seguridad

Los tokens API se cargan desde variables de entorno
El contenido del archivo se codifica correctamente antes de la transmisión.
Los mensajes de error se desinfectan para evitar fugas de información
No se requiere acceso al sistema de archivos: todo el contenido lo proporciona el cliente MCP