Machina

machina-mcp

MCP サーバーとしての Machina。 x402 の統合は不要です。Machina の x402 対応エージェントサービスを、Claude Desktop、Cursor、または MCP 互換の AI ホストから直接利用できます。

ツールを呼び出すたびに、支払いが自動で行われます。一度設定すれば、あとは利用した分だけのお支払いです。

ツール

ツール	機能	料金
url_extract	任意の URL を取得 → クリーンな Markdown	$0.005
scan_python	Python コードのセキュリティ脆弱性をスキャン	$0.020
validate_email	単一のメールアドレスを検証（構文、MX、SMTP）	$0.007
validate_email_bulk	最大 100 件のメールアドレスを検証	$0.500
domain_intel	ドメインの DNS、WHOIS、SSL、技術スタックを取得	$0.050
pdf_inspect	PDF のページ数とメタデータを取得	無料
pdf_extract	PDF → Markdown（50 ページ以下）	$0.050
pdf_extract_large	PDF → Markdown（200 ページ以下）	$0.180

支払いにはBase（Coinbase の L2）上の USDC を使用します。ガス代は 1 セント未満です。

---

クイックスタート

1. インストール

pip install machina-mcp

2. ウォレットを用意して入金する

Base メインネット上に少額の USDC 残高がある Ethereum ウォレットが必要です。

オプション A — 新しいウォレット（最も簡単）：

python -c "from eth_account import Account; a = Account.create(); print('Address:', a.address); print('Key:', a.key.hex())"

アドレスをコピーし、Coinbase または bridge.base.org 経由で Base 上の 1～5 USDC を送金します。

オプション B — 既存のウォレット： MetaMask から秘密鍵をエクスポートします：アカウントの詳細 → 秘密鍵をエクスポート。

3. キーを設定する

export MACHINA_WALLET_KEY=0xYOUR_PRIVATE_KEY

4. Claude Desktop に追加する

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "machina": {
      "command": "machina-mcp",
      "env": {
        "MACHINA_WALLET_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Claude Desktop を再起動します。8 つの Machina ツールが自動的に表示されます。

---

使用例

接続したら、Claude に次のように尋ねます。

• 「https://example.com のコンテンツを抽出して」 → url_extract を使用
• 「この Python コードにセキュリティ上の問題がないかスキャンして：[コードを貼り付け]」 → scan_python を使用
• 「[email protected] が実在するメールアドレスか確認して」 → validate_email を使用
• 「openai.com の DNS と WHOIS 情報を取得して」 → domain_intel を使用
• 「この PDF は何ページ？」 → pdf_inspect を使用（無料）
• 「report.pdf からテキストを抽出して」 → pdf_extract を使用

---

設定

環境変数	必須	デフォルト	説明
MACHINA_WALLET_KEY	✅	—	Ethereum の秘密鍵（16 進数、0x プレフィックス付き）
MACHINA_NETWORK	❌	eip155:8453	CAIP-2 ネットワーク ID（Base メインネット）
MACHINA_BASE_URL	❌	https://mach402.dev	Machina API のベース URL

テストネットモード（無料、モック決済）：

export MACHINA_NETWORK=eip155:84532
export MACHINA_BASE_URL=https://mach402.dev  # testnet endpoints at same URL when TESTNET_MODE=true

---

支払いの仕組み

1. エージェントが Machina MCP ツール（例：url_extract）を呼び出します
2. MCP サーバーがリクエストを mach402.dev に送信します
3. Machina が 402 Payment Required と正確な USDC 金額を返します
4. MCP サーバーがウォレットキーを使って x402 決済に署名し、自動的に送信します
5. Machina がオンチェーンで支払いを検証し、結果を返します
6. 結果がエージェントに返されます

エージェントはこれらの処理を意識する必要はありません。ツールを呼び出して結果を受け取るだけです。

---

単独で実行する（テスト用）

# Test with MCP Inspector
npx @modelcontextprotocol/inspector machina-mcp

# Or run directly
export MACHINA_WALLET_KEY=0x...
machina-mcp

---

料金

Machina は Base メインネット上で、呼び出しごとに USDC で課金します。支払いは Coinbase CDP 経由でオンチェーン決済されます。サブスクリプション、最低利用額、月額料金はありません。

5 USDC の残高で、URL 抽出なら約 1,000 回、Python コードのスキャンなら約 250 回利用できます。

---

リンク

• API ドキュメント： https://mach402.dev/docs
• 購入者ガイド： https://mach402.dev/docs/buyer-guide
• ソースコード： https://github.com/NyTerry/machina-mcp
• 問題の報告： https://github.com/NyTerry/machina-mcp/issues

---

ライセンス

MIT