MCP Mistcash

🚀 MIST.cash SDK用MCPサーバー

Starknetにおいて、MIST.cashのプライベート決済機能を公開するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、標準化されたインターフェースを介して、AIエージェントがMIST.cashのプライバシー保護型決済プロトコルとやり取りできるようにします。

✨ 主な機能

• トランザクション操作のための 5つのMCPツール
• コントラクトとトランザクションの情報のための 2つのMCPリソース
• プライバシー至上: MIST.cashのゼロ知識証明システムを活用
• マルチトークン対応: Starknet上のETH、USDC、USDT、DAI
• 本番環境対応: リトライロジック、タイムアウト設定、完全なエラーハンドリング

📦 インストール

前提条件

• Node.js 20以上（ローカルで実行する場合）
• Docker（チームでの利用を推奨）
• StarknetのRPCプロバイダー（または互換性のあるAppchain）へのアクセス

インストール方法

オプション1: Docker（チーム向け推奨）

これはチーム内の全員が同じ環境を持つための最も簡単な方法です。

1. イメージのビルド

docker build -t mcp-mistcash .

2. Dockerで実行 MCPクライアント（Claude Desktopなど）で使用するには、docker runコマンドを使用します。標準入出力の通信に必要な-iフラグに注意してください。

docker run -i --rm \
  -e STARKNET_RPC_URL=https://ztarknet-madara.d.karnot.xyz \
  -e STARKNET_NETWORK=mainnet \
  -e CHAMBER_CONTRACT_ADDRESS=0xTuDireccionDeContrato \
  mcp-mistcash

オプション2: ローカル開発（Node.js）

1. クローンと依存関係のインストール

cd mcp-mistcash
npm install

2. 環境変数の設定 .env.exampleを元に.envファイルを作成します。

cp .env.example .env

.envファイルを編集して設定を行います（Madara Appchainの例）。

STARKNET_RPC_URL=https://ztarknet-madara.d.karnot.xyz
STARKNET_NETWORK=mainnet
MCP_LOG_LEVEL=info
# オプション: Chamberコントラクトのアドレス（Madaraでメインネットを使用しない場合に必要）
# CHAMBER_CONTRACT_ADDRESS=0x...

3. プロジェクトのビルド

npm run build

💻 使用例

基本的な使用法

このサーバーを使用するには、まずインストールと設定を行い、次にAIクライアントと統合します。以下は、Claude DesktopとCursor IDEでの使用例です。

Claude Desktop

Claude Desktopで使用するには、設定ファイルclaude_desktop_config.jsonに以下の内容を追加します。 設定ファイルのパス

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Dockerを使用した設定（推奨）

{
  "mcpServers": {
    "mist-cash": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "STARKNET_RPC_URL=https://ztarknet-madara.d.karnot.xyz",
        "-e", "STARKNET_NETWORK=mainnet",
        "mcp-mistcash"
      ]
    }
  }
}

ローカルでの設定（代替案）

{
  "mcpServers": {
    "mist-cash": {
      "command": "node",
      "args": ["/ruta/absoluta/a/mcp-mistcash/dist/index.js"],
      "env": {
        "STARKNET_RPC_URL": "https://ztarknet-madara.d.karnot.xyz",
        "STARKNET_NETWORK": "mainnet"
      }
    }
  }
}

Cursor IDE

CursorのMCP設定に以下の内容を追加します。

{
  "mist-cash": {
    "command": "docker",
    "args": [
        "run",
        "-i",
        "--rm",
        "-e", "STARKNET_RPC_URL=https://ztarknet-madara.d.karnot.xyz",
        "-e", "STARKNET_NETWORK=mainnet",
        "mcp-mistcash"
    ]
  }
}

高度な使用法

このサーバーは、いくつかのMCPツールとリソースを提供しています。以下は、利用可能なツールとリソースの説明です。

利用可能なツール

1. generar_secreto_transaccion

プライベートトランザクションの暗号化されたシークレットを生成します。 パラメーター

• claiming_key (string, 必須): トランザクションの請求キー
• recipient_address (string, 必須): Starknetアドレス（0x...）

2. obtener_assets_transaccion

トランザクションの資産を取得します。

⚠️ 重要な注意 この関数は、すでに使用された資産も表示します。正確な検証にはverificar_existencia_transaccionを使用してください。

パラメーター

• transaction_key (string, 必須): 照会するトランザクションのキー
• recipient_address (string, 必須): 受信者のStarknetアドレス
• provider_rpc_url (string, オプション): カスタムRPC URL

3. verificar_existencia_transaccion

特定の資産を持つトランザクションが存在するかどうかを検証します。完全にプライベートなトランザクションに最適です。 パラメーター

• claiming_key (string, 必須): 請求キー
• recipient (string, 必須): 受信者のアドレス
• token_address (string, 必須): トークンコントラクトのアドレス
• amount (string, 必須): 基本単位（wei）での金額

4. calcular_hash_transaccion

トランザクションの一意のハッシュを計算します。 パラメーター

• transaction_key (string, 必須): トランザクションのキー
• recipient_address (string, 必須): 受信者のアドレス
• token_address (string, 必須): トークンのアドレス
• amount (string, 必須): 基本単位での金額

5. obtener_configuracion_chamber

Chamberコントラクトの設定とサポートされているトークンを取得します。 パラメーター

• network (enum, オプション): "mainnet"または"sepolia"（デフォルト: "mainnet"）

利用可能なリソース

chamber://contract-info

MIST.cashのChamberコントラクトに関する静的情報（ABI、アドレス、機能など）を提供します。

chamber://tx/{txHash}

特定のトランザクションの詳細をハッシュで取得します。

🔧 技術詳細

セキュリティに関する考慮事項

安全な実践

• 秘密鍵を使用しない: 請求キー（公開キー）のみを扱います。
• アドレスの検証: すべてのStarknetアドレスが検証されます。
• 安全なロギング: トランザクションのシークレットはログに記録されません。
• 入力の検証: Zodスキーマを使用してすべての入力を検証します。

重要な警告

1. 使用済みトランザクション: obtener_assets_transaccionは使用済みの資産を検出しません。
2. RPCコスト: RPCの使用を監視して、予期しないコストを避けてください。
3. ネットワーク遅延: すべてのコントラクト呼び出しに30秒のタイムアウトが設定されています。

プロジェクトの構造

mcp-mistcash/
├── src/
│   ├── index.ts                 # 主要なMCPサーバー
│   ├── types.ts                 # TypeScriptの型定義
│   ├── tools/                   # ツールの実装
│   ├── resources/               # MCPリソース
│   └── utils/                   # ユーティリティ（プロバイダー、検証）
├── Dockerfile                   # Dockerイメージのビルド設定
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

🤝 コントリビューション

コントリビューションは歓迎されます。以下の点に注意してください。

1. すべてのツールが適切なエラーハンドリングを持っていること。
2. Zodスキーマが入力を検証すること。
3. コードがTypeScriptのベストプラクティスに従っていること。
4. ドキュメントが最新であること。

📄 ライセンス

MIT

StarknetとMCPのコミュニティのために❤️で構築されました