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

1. Clonar este repositorio

2. Instalar dependencias:

   npm install

3. Construir el servidor:

   npm run build

Related MCP server: AOTrust - PDR Notarization

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

• https://pypi.org/project/mcp-server-fetch/

• https://www.npmjs.com/package/@mcp-dockmaster/mcp-cryptowallet-evm

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