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 ベアラートークンです。新しいトークンは Molecule の Discord サーバーでリクエストできます：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 ハッシュを作成してください ... | POI ハッシュを使って、base ブロックチェーン上の 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 クライアントから提供されます