mossgate-mcp

mossgate-mcp

MCP 対応エージェントで利用できる、2 つの有料 API を公開する Model Context Protocol（MCP）stdio サーバーです。

• mossgate trust（https://api.mossgate.dev）トークンとウォレットのリスクチェック
• rue render（https://rue.mossgate.dev）URL／HTML から PDF／PNG／JPEG への変換

支払い方式は x402 v2 で、Base 上の USDC を使用します。このサーバーを実行するオペレーターがウォレットに資金を用意し、ツールを呼び出すたびに少額の USDC が使われます。ウォレットは EIP-3009 認証をガス代なしで署名するため、必要なのは USDC のみで、ガス代用の ETH は不要です。

ツール

• token_verdict(address, chain=base) トークンコントラクトの簡易リスク判定
• wallet_profile(address, chain=base) ウォレットの行動リスクプロファイル
• token_report(address, chain=base) トークンの完全なレポート
• render(url|html, format=pdf|png|jpeg) ページを変換し、Base64 ファイルを返します

インストール

cd mcp-server
npm install

Node 18 以降が必要です。

ウォレットに資金を用意する

1. EVM ウォレットを新規作成するか、既存のものを使用します（0x 形式の秘密鍵を取得できるツールであれば何でも構いません）。
2. Base 上の USDC を送金します（コントラクトは 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913）。数ドルあれば多数の呼び出しに対応できます。ETH は不要です。ガス代はファシリテーターが負担します。
3. 秘密鍵を環境変数としてエクスポートします（絶対にコミットしないでください）。

export MOSSGATE_BUYER_PK=0xyourprivatekey

必要に応じて、MOSSGATE_RPC（Base RPC URL）、 MOSSGATE_TRUST_URL、MOSSGATE_RENDER_URL を上書きできます。

スタンドアロンで実行する

MOSSGATE_BUYER_PK=0x... node index.js

このサーバーは stdio 経由で MCP を使用します。手動で使うのではなく、MCP クライアントから起動することを想定しています。

Claude Desktop／MCP クライアントの設定

MCP クライアントの設定に以下を追加します（Claude Desktop の場合： Linux では ~/.config/Claude/claude_desktop_config.json、macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）。

{
    "mcpServers": {
        "mossgate": {
            "command": "node",
            "args": ["/absolute/path/to/products/mcp-server/index.js"],
            "env": {
                "MOSSGATE_BUYER_PK": "0xyourprivatekey"
            }
        }
    }
}

クライアントを再起動します。4 つのツールが表示され、呼び出しのたびに資金を用意したウォレットから自動で支払われます。

起動を確認する（有料の呼び出しなし）

API にアクセスしたり、費用を発生させたりせずに、stdio 経由でツールの一覧を取得します。

printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
| node index.js

クローンせずに実行する

このパッケージは npm で公開されているため、エージェントやクライアントはクローンやインストールをせずに npx 経由で実行できます。クライアント設定で command を npx に、args を ["-y", "mossgate-mcp"] に設定します。

{
    "mcpServers": {
        "mossgate": {
            "command": "npx",
            "args": ["-y", "mossgate-mcp"],
            "env": {
                "MOSSGATE_BUYER_PK": "0xyourprivatekey"
            }
        }
    }
}