Tempo MCP

🚀 tempo-mcp

Tempoブロックチェーンの安定コイン支払い用MCPサーバー — AIエージェントが現実世界の支払いを自律的に実行できるようにします。

テストネットのみ — このMCPは現在、Tempoテストネット上で動作しています。実際の資金は使用されません。実験や開発に最適です！

🚀 クイックスタート

前提条件

• Node.js 20.0.0以上
• npm、pnpm、またはyarn
• AlphaUSDトークンを持つTempoテストネットウォレット

初めての方は：docs.tempo.xyz/faucet でウォレットを取得し、無料のテストネットトークンを入手してください。

インストール

npmを使用したグローバルインストール：

npm install -g tempo-mcp

npxを使用したインストール（インストール不要）：

npx tempo-mcp

ソースからのインストール：

git clone https://github.com/arome3/tempo-mcp
cd tempo-mcp
npm install
npm run build

設定

1. .envファイルを作成します：

cp .env.example .env

2. ウォレットの秘密鍵を追加します：

# 必須
TEMPO_PRIVATE_KEY=0x...  # あなたのウォレットの秘密鍵

# ネットワーク（デフォルトはテストネット）
TEMPO_RPC_URL=https://rpc.testnet.tempo.xyz
TEMPO_CHAIN_ID=42429

3. サーバーを起動します：

npm start
# または
npx tempo-mcp

IDEでのインストール

以下からMCPクライアントを選択し、詳細なセットアップ手順を参照してください。

注意：ここに記載されていないクライアントを使用している場合でも、クライアントのMCP設定にサーバー構成を手動で追加することでtempo-mcpを使用できます。

Claude Desktop

まだダウンロードしていない場合は、Claude Desktopをダウンロードしてインストールします。

手動設定：

1. Claude Desktopを開きます。
2. 設定（歯車アイコン）→ 開発者に移動します。
3. 構成を編集をクリックして、構成ファイルを開きます。
   • macOS/Linux: ~/.config/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. 以下の構成を追加します：

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": {
        "TEMPO_PRIVATE_KEY": "0x...",
        "TEMPO_RPC_URL": "https://rpc.testnet.tempo.xyz"
      }
    }
  }
}

5. ファイルを保存し、Claude Desktopを再起動します。

Claude Code (CLI)

まだインストールしていない場合は、Claude Codeをインストールします。

ワンクリック設定：

claude mcp add tempo-mcp -e TEMPO_PRIVATE_KEY=0x... -- npx tempo-mcp

手動設定：

1. ターミナルを開きます。
2. claude mcp add tempo-mcpを実行して、サーバーを追加します。
3. または、構成ファイルを直接編集します：
   • macOS: ~/.claude/settings.json
   • Linux: ~/.claude/settings.json
   • Windows: %USERPROFILE%\.claude\settings.json
4. 以下の構成を追加します：

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": {
        "TEMPO_PRIVATE_KEY": "0x..."
      }
    }
  }
}

5. Claude Code内で/mcpコマンドで確認します。

Cursor

まだダウンロードしていない場合は、Cursorをダウンロードしてインストールします。

手動設定：

1. Cursorでプロジェクトを開き、Cursor設定（macOSでは⌘+Shift+J）に移動します。
2. 設定メニューで、MCPセクションに移動します。
3. 新しいMCPサーバーをクリックします。これにより、mcp.json構成ファイルが開きます。
   • グローバル: ~/.cursor/mcp.json
   • プロジェクトレベル: .cursor/mcp.json（プロジェクトルート）
4. 以下の構成を追加します：

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": {
        "TEMPO_PRIVATE_KEY": "0x..."
      }
    }
  }
}

5. 保存し、Cursorを再起動します。

ヒント：プロジェクトレベルの構成（.cursor/mcp.json）は、グローバル構成を上書きします。

Windsurf

まだダウンロードしていない場合は、Windsurfをダウンロードしてインストールします。

手動設定：

1. Windsurfを開き、設定（macOSでは⌘+,）に移動します。
2. Cascade → プラグインに移動します。
3. 生の構成を表示をクリックして、MCP構成ファイルを開きます。
   • macOS: ~/.codeium/windsurf/mcp_config.json
   • Linux: ~/.config/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
4. 以下の構成を追加します：

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": {
        "TEMPO_PRIVATE_KEY": "0x..."
      }
    }
  }
}

5. 保存し、Windsurfを再起動します。

VS Code + Continue

VS CodeにContinue拡張機能をインストールします。

手動設定：

1. VS Codeを開き、サイドバーのContinueアイコンをクリックします。
2. 歯車アイコン → 構成ファイルを開くをクリックします。
   • macOS: ~/.continue/config.yaml
   • Linux: ~/.continue/config.yaml
   • Windows: %USERPROFILE%\.continue\config.yaml
3. 以下の構成を追加します（YAML形式）：

mcpServers:
  - name: tempo
    command: npx
    args:
      - tempo-mcp
    env:
      TEMPO_PRIVATE_KEY: "0x..."

4. 保存し、VS Codeを再読み込みします。

注意：MCPツールはContinueのエージェントモードでのみ使用できます。

Cline

VS CodeにCline拡張機能をインストールします。

手動設定：

1. VS Codeを開き、サイドバーのClineアイコンをクリックします。
2. 上部ナビゲーションバーのMCPサーバーアイコンをクリックします。
3. 設定タブを選択し、高度なMCP設定をクリックします。
4. これにより、以下の場所にある構成ファイルが開きます：
   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
5. 以下の構成を追加します：

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": {
        "TEMPO_PRIVATE_KEY": "0x..."
      },
      "alwaysAllow": [],
      "disabled": false
    }
  }
}

6. 保存すると、サーバーがすぐに利用可能になります。

汎用MCPクライアント

カスタムMCPクライアントまたはプログラムによる使用の場合：

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "npx",
  args: ["tempo-mcp"],
  env: {
    TEMPO_PRIVATE_KEY: process.env.TEMPO_PRIVATE_KEY,
  },
});

const client = new Client({ name: "my-agent", version: "1.0.0" }, {});
await client.connect(transport);

// これでツールを呼び出せます
const result = await client.callTool({
  name: "get_balance",
  arguments: { token: "AlphaUSD" },
});

✨ 主な機能

支払い操作

• 単一の支払い — 任意のメモ付きでTIP-20安定コインを送信します。
• 一括支払い — 最大100人の受取人に対するアトミックな複数受取人転送を行います。
• 並列支払い — nonceKeysを使用した並列実行（大量の一括支払いでは10 - 100倍高速）。
• 予定支払い — プロトコルレベルでの将来の支払いを実行ウィンドウ付きで設定します。
• スポンサー付き支払い — スポンサーが手数料を支払うガスレストランザクション（ローカルキーまたはリレーサービス）。

クエリ操作

• 残高照会 — 単一または複数のトークン残高を確認します。
• トランザクション検索 — トランザクションの詳細と履歴を取得します。
• ガス推定 — トランザクションのコストを推定します。

トークン操作

• トークン作成 — ファクトリーコントラクトを介して新しいTIP-20トークンをデプロイします。
• 発行/焼却 — トークンの供給量を管理します（ISSUER_ROLEが必要）。
• 交換 — Tempo DEXで安定コインを交換します。
• ロール管理 — TIP-20のロール（管理者、発行者、一時停止、再開）を付与、取り消し、照会します。
• 一時停止制御 — トークンのすべての転送を緊急一時停止/再開します（PAUSE_ROLE/UNPAUSE_ROLEが必要）。
• ポリシーコンプライアンス — TIP-403のホワイトリスト/ブラックリスト管理と転送前の検証を行います。
• 報酬管理 — TIP-20の報酬参加：参加/脱退、報酬の請求、受取人の設定、状態の確認を行います。
• 手数料AMM流動性 — ガス手数料変換プールに流動性を提供し、安定コインの交換から収益を得ます。
• DEXの高度な注文 — 指値注文、フリップ注文（自動反転）、オーダーブッククエリ、および注文管理を行います。

セキュリティ

• 支出制限 — トークンごとおよび日次のUSD制限を設定します。
• アドレスホワイトリスト — 受取人アドレスをホワイトリストまたはブラックリストに登録します。
• レート制限 — 操作タイプごとに設定可能な制限を設けます。
• 監査ログ — リクエストトレーシング付きの構造化JSONログを記録します。
• アクセスキー（セッションキー） — トークンごとの支出制限と有効期限付きの委任署名を行います。

ウォレットサポート

• 秘密鍵 — 開発/テスト用の直接キー。
• キーストア — 本番環境用の暗号化されたJSONキーストア。
• 外部署名者 — エンタープライズ用のTurnkey/Fireblocks統合。

💻 使用例

基本的な使用法

{
  "mcpServers": {
    "tempo": {
      "command": "npx",
      "args": ["tempo-mcp"],
      "env": { "TEMPO_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY" }
    }
  }
}

その後、Claudeに*"What's my AlphaUSD balance?"*と尋ねます。

高度な使用法

User: "Send 100 AlphaUSD to 0x... using sponsored gas"

→ Claude calls send_sponsored_payment({
    token: "AlphaUSD",
    to: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb",
    amount: "100",
    useRelay: false  // Use local fee payer
  })

→ Returns: {
    success: true,
    transactionHash: "0xdef456...",
    feePayer: "0xabc...",
    feeAmount: "0.000073"
  }

📚 ドキュメント

MCPツールリファレンス

支払いツール（高リスク）

クエリツール（低リスク）

トークンツール（高リスク）

ポリシーツール（TIP-403コンプライアンス）

ポリシータイプ：whitelist（承認されたアドレスのみが取引できる）またはblacklist（特定のアドレスをブロック）。組み込みポリシー：0（常に拒否）、1（常に許可）。カスタムポリシーはID 2から始まります。

アクセスキーツール（セッションキー）

報酬ツール（TIP-20報酬）

期間：duration = 0を設定すると即時分配になります。時間ベースのストリーミング報酬（duration > 0）は将来のプロトコルアップデートで予定されています。

交換ツール

手数料AMMツール（流動性管理）

DEXの高度なツール（オーダーブック取引）

Tick価格：Price = 1 + tick/100,000。Tick 0 = $1.0000、tick -10 = $0.9999、tick 10 = $1.0001

MCPリソースリファレンス

リソースは、URIパターンを介してブロックチェーンデータへの読み取り専用アクセスを提供します：

使用例：

Read tempo://account/0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb

MCPプロンプトリファレンス

プロンプトは、再利用可能な会話テンプレートを提供します：

設定

環境変数

設定ファイル

高度な設定のためにtempo-mcp.config.yamlを作成します：

network:
  rpcUrl: https://rpc.testnet.tempo.xyz
  chainId: 42429
  explorerUrl: https://explore.tempo.xyz

wallet:
  type: privateKey  # または 'keystore', 'external'

security:
  spendingLimits:
    maxSinglePayment:
      "*": "1000"           # すべてのトークンのデフォルト
      AlphaUSD: "5000"      # 特定のトークンの上書き
    dailyLimit:
      "*": "10000"
    dailyTotalUSD: "50000"
    maxBatchSize: 50
    maxBatchTotalUSD: "25000"

  addressAllowlist:
    enabled: true
    mode: allowlist         # または 'blocklist'
    addresses:
      - "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbb"
    labels:
      "0x742d35Cc...": "Payroll Account"

  rateLimits:
    toolCalls:
      windowMs: 60000
      maxCalls: 60
    highRiskOps:
      windowMs: 3600000
      maxCalls: 100

logging:
  level: info
  auditLog:
    enabled: true
    path: ./logs/audit.jsonl
    rotationDays: 30

feeSponsorship:
  enabled: true
  feePayer:
    type: local              # または 'relay' テストネットリレーサービス用
    address: "0x..."         # 手数料支払いウォレットのアドレス
    privateKey: "0x..."      # 手数料支払いの秘密鍵（ローカルモードのみ）
    relayUrl: "https://sponsor.testnet.tempo.xyz"  # リレーエンドポイント
  maxSponsoredPerDay: "1000" # 日次スポンサーシップ制限

設定の優先順位

1. 環境変数（最も高い優先順位）
2. 設定ファイル（tempo-mcp.config.yaml/yml/json）
3. デフォルト値（最も低い優先順位）

🔧 技術詳細

セキュリティ

tempo-mcpには、不正なトランザクションから保護するための複数のセキュリティ層が含まれています：

支出制限

大きなまたは過度の支払いを防止します：

security:
  spendingLimits:
    maxSinglePayment:
      "*": "1000"           # トランザクションあたり最大$1000
    dailyLimit:
      "*": "10000"          # トークンごとの1日あたり最大$10,000
    dailyTotalUSD: "50000"  # 1日あたりの合計最大$50,000

アドレスホワイトリスト

支払いを受け取ることができるアドレスを制限します：

security:
  addressAllowlist:
    enabled: true
    mode: allowlist         # リストされたアドレスのみ許可
    addresses:
      - "0x..."             # 承認された受取人
    labels:
      "0x...": "Vendor A"   # 人間が読めるラベル

レート制限

悪用や暴走エージェントを防止します：

security:
  rateLimits:
    toolCalls:
      windowMs: 60000       # 1分のウィンドウ
      maxCalls: 60          # 1分あたり最大60回の呼び出し
    highRiskOps:
      windowMs: 3600000     # 1時間のウィンドウ
      maxCalls: 100         # 1時間あたり最大100回の高リスク操作

監査ログ

すべての操作はコンプライアンスのためにログに記録されます：

{"timestamp":"2024-12-17T10:30:00Z","requestId":"abc123","tool":"send_payment","status":"success","tx":"0x...","amount":"100","to":"0x..."}

ネットワーク情報

Tempoテストネット（Andantino）

デフォルトトークン

テクノロジースタック

トラブルシューティング

⚠️ 重要提示

以下のトラブルシューティングガイドを参照して、一般的な問題を解決してください。

"Connection refused"エラー

• Node.js 20以上がインストールされていることを確認します：node --version
• 設定ファイルにTEMPO_PRIVATE_KEYが設定されていることを確認します。

"Insufficient balance"エラー

• フォーケットからテストネットトークンを取得します。
• 残高を確認します：Claudeに*"What's my balance?"*と尋ねます。

"Spending limit exceeded"エラー

• 環境変数または設定ファイルでTEMPO_MAX_SINGLE_PAYMENTを増やします。
• 今日たくさんのトランザクションを行った場合は、TEMPO_DAILY_LIMITを確認します。

"Token not found"エラー

• トークンシンボル（AlphaUSD）または完全なアドレス（0x20c0...0001）を使用します。
• ネットワーク情報セクションでサポートされているトークンを確認します。

サーバーが応答しない場合

• 設定変更後にClaude Desktopを再起動します。
• ログを確認します：tail -f ~/.config/Claude/logs/mcp*.log

📄 ライセンス

MITライセンス — 詳細についてはLICENSEを参照してください。

謝辞

• Tempo — 安定コイン支払いブロックチェーン
• Anthropic — モデルコンテキストプロトコル
• viem — TypeScript Ethereumライブラリ

コネクト

Abraham Onojaによって開発されました。

質問、フィードバック、または協力したい場合は、お問い合わせください！

エージェント型コマースの時代に向けて構築されました