Mcp Poi

MCP POI 服务

一个用于处理文件并准备区块链交易的 Model Context Protocol 服务。此服务可安装在 Claude Desktop 中，并提供一个用于处理文件并为区块链交易做好准备的工具。

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

设置

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 构建服务：

   npm run build
   

环境变量

• API_TOKEN：用于向 PoI API 进行身份验证的 API bearer token。你可以在 Molecule 的 Discord Server 上申请新令牌：https://discord.gg/k4ER7vZcj8

用法

此服务提供了一个名为 create_proof_of_invention_request 的工具，该工具接受文件路径，并返回适用于在区块链上执行的已准备交易数据。你可以将其交由喜欢的、能够签署并提交交易的工具重复使用。二进制内容应由 MCP 客户端（例如 Claude Desktop 或 Cursor）提供。

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

添加到 Claude Desktop

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

可与其他 MCP 服务配合使用

• https://pypi.org/project/mcp-server-fetch/
• https://www.npmjs.com/package/@mcp-dockmaster/mcp-cryptowallet-evm

我们完整的 Claude desktop 配置如下：

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

提示词

| 从我 Documents 文件夹中的“idea.md”文件创建 poi 哈希 ... | 在 base 区块链上，向 poi 的地址发送一笔带有 poi 哈希的 Eth 交易

工具架构

输入：

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

输出：

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

运行服务

npm start

开发

如需在开发时自动重新构建：

npm run dev

错误处理

此服务针对以下情况提供了稳健的错误处理：

• 缺少环境变量
• 文件内容无效
• API 通信错误
• 响应格式无效

安全性

• 从环境变量加载 API 令牌
• 在传输前对文件内容进行正确编码
• 对错误消息进行清理，以防止信息泄露
• 无需访问文件系统——所有内容均由 MCP 客户端提供