littlejohn-mcp

Little John MCP

Little John MCP は、ローカルの Robinhood Chain MCP アプリケーションおよび対話型 CLI です。 アセットとコントラクトを読み込み、USDG / Stock Token の交換判断を構築し、WalletConnect を通じて接続済みウォレットで直接確認されたトランザクションを要求して、受信したハッシュと実際のトランザクション結果をローカルに記録します。

このドキュメントでは、ソースコードのチェックアウトについて説明します。公開済みのインストール済み成果物については、そのリリースのソースリビジョンにあるドキュメントを参照してください。

現在のサポート範囲は製品ポリシーに記載されています。 交換アクションは実装済みです。Robinhood Wallet のトランザクションおよび置換の動作は適格性が確認されていません。このパッケージは、実行可能性またはレシートによる検証済みのサポートを主張していません。 データ署名は、アプリの直接操作と対話型 CLI を通じて、パーソナルメッセージと EIP-712 型付きデータに対応しています。Robinhood Wallet および各 MCP Host アプリケーションでの実機検証は未完了です。

公開リリースをインストールする

パッケージの engines フィールドを満たす Node.js を使用してください。

npm install --global @zktx.io/littlejohn-mcp
littlejohn-mcp --help

ソースからインストールする

同じ Node.js 要件を満たす環境で、リポジトリをチェックアウトして実行します。

npm ci
LITTLEJOHN_MCP_RELEASE_OUTPUT=/absolute/path/littlejohn-mcp.tgz npm run release:check
npm install --global /absolute/path/littlejohn-mcp.tgz
littlejohn-mcp --help

リリースチェックでは、自動パッケージチェックに合格した後にのみ tarball が作成されます。npm への公開や、実機 Wallet の適格性確認は行いません。SQLite は npm の依存関係です。別途 SQLite サーバーやコマンドラインツールをインストールする必要はありません。 ネイティブアドオンのインストールも npm install の一部です。プログラムを起動する前に、インストールエラーを解決する必要があります。

MCP Host を接続する

MCP Host の用語については、 アーキテクチャで定義されています。

MCP Host の MCP 設定で、littlejohn-mcp という名前のローカル stdio サーバーを設定します。

{
  "mcpServers": {
    "littlejohn-mcp": {
      "command": "littlejohn-mcp",
      "args": []
    }
  }
}

MCP Host がシェルの実行ファイル検索パスを継承しない場合は、インストール済み実行ファイルの絶対パスを使用してください。ウェブサイト、公開サーバー、ブラウザーへのログイン、または移動可能なループバックページは必要ありません。引数なしのプロセスは MCP を提供します。CLI コマンドは同じローカルバックエンドと Wallet セッションを使用します。

オプションの RPC エンドポイントを使用する場合は、そのサーバーの環境変数に LITTLEJOHN_MCP_RPC_URL を追加します。省略すると、Runtime の公開デフォルトが使用されます。空文字列は設定しないでください。指定した URL は、現在の HTTPS 設定の受け入れ条件を満たす必要があります。満たさない場合、別のプロバイダーには切り替わりません。認証情報を含む URL は、コマンド引数ではなく MCP Host の安全な設定に保存してください。標準設定フィールドは server.jsonにあります。

LITTLEJOHN_MCP_DATA_DIR は、別のローカルプロファイルディレクトリを指定します。 LITTLEJOHN_MCP_WALLETCONNECT_PROJECT_ID は、Wallet アダプターのプロジェクト ID を上書きします。 プロファイルを共有するすべてのプロセスで、同じ設定を使用する必要があります。バックエンドは固定のループバックポートを使用します。他のプロセスがそのポートを使用している場合はエラーとなり、別のポートを選択する理由にはなりません。設定の全動作については、 アーキテクチャを参照してください。

バックエンドのライフサイクルとメンテナンス

通常の MCP および CLI の使用では、独立したローカルバックエンドが自動的に起動します。このバックエンドは、ホストが MCP 接続を閉じた後も、ウォレットセッションと保留中の処理を維持します。バックグラウンドの Node プロセスとその SDK ワーカーは、明示的に停止されるか、オペレーティングシステムによって終了されるか、致命的なバックエンド障害によって停止されるまで、メモリとローカルファイルを使用し続けます。アイドル状態になっても自動停止しません。

接続しているクライアントと同じプロファイルおよび設定を使用してください。

littlejohn-mcp runtime status --json
littlejohn-mcp runtime stop --json

これらのコマンドではバックエンドは起動しません。停止すると、そのバックエンドを共有しているすべてのクライアントに影響しますが、承認済みのウォレットセッションは取り消されません。停止するのは、観測された1つのバックエンドの世代です。その後、通常のクライアントリクエストによって別のバックエンドが起動することがあります。メンテナンス、更新、アンインストール、または npx キャッシュの削除を行う前に、影響を受ける MCP 接続を一時停止してください。その後、バックエンドを停止し、ファイルを削除する前に released を確認してください。他のホストアプリケーションは、それぞれのアプリで直接設定してください。

stop が shutdown_unconfirmed を返した場合は、その対象を保持してください。表示された runtime status --shutdown <owner-instance-id> コマンドは、何も起動または停止せずに、その世代の保存済み結果を読み取ります。リスナーが見つからないことや、停止の確認応答だけでは、リソースが解放された証拠にはなりません。互換性のないインストール済みパッケージや設定がある場合は、フェイルクローズします。Little John MCP がその別プロセスを自動的に終了または更新することはありません。

別のプロファイルまたはインストール済みバージョンがポートを使用している場合は、影響を受けるホスト接続を一時停止し、そのバックエンドの元の信頼できるインストール、プロファイル、設定を使って runtime stop を実行してください。新しいバージョンでは、互換性のないバックエンドを停止できません。そのインストールが利用できない場合、またはバックエンドが応答しなくなった場合は、オペレーティングシステムのプロセス管理ツールで Little John MCP の正確なバックエンドを特定し、手動で終了してください。ポートの競合を解消するために、すべての Node プロセスを終了したり、データベースや認証情報を削除したりしないでください。認証されていないリスナーが報告したプロセスは、信頼できる終了対象ではありません。ファイルを削除する前に、バックエンドとその SDK ワーカーがプロファイルを使用しなくなったことを確認してください。手動で終了しても、リクエストがキャンセルされたことやリソースが解放されたことの証明にはなりません。復旧後に元の操作を確認し、不確かなトランザクションや署名リクエストを再送しないでください。

アプリケーションを使用する

App 対応の MCP ホストで、希望する資産の読み取りまたは取引の判断を通常の言葉で依頼します。Stock Token、プール、送信または受取数量、正確な数量／最大数量／最小数量の条件、手数料の上限、実行期限を指定します。トークンの単位は原株とは異なります。Little John MCP は、取引に不可欠な条件が不足していても、黙って選択することはありません。

アプリの直接操作を使って、表示された取引をウォレットに要求します。ウォレットは別途、承認を求めます。モデルから参照可能なツールでは、その要求を承認できません。アプリを直接操作できない MCP ホストでは、引き続き取引を承認できません。CLI は独立したインターフェースです。

CLI では、現在の完全な構文を littlejohn-mcp --help で確認できます。

• littlejohn-mcp wallet connect は接続の判断画面とペアリング用 QR コードを表示します。
• littlejohn-mcp uniswap-v4 list-pools <stock-token-address> は、現在の公式資産スナップショットに残っている、パッケージに含まれる候補を一覧表示します。流動性や最適なルートを保証するものではありません。
• littlejohn-mcp exchange start ... は新しい判断を構成し、ウォレットに要求する前に、対話形式で y の入力を求めます。入力と出力の両方が TTY である必要があります。フラグ、リダイレクトされた入力、JSON 出力では取引を確定できません。
• littlejohn-mcp exchange replace-fees ... は、独立して読み取った保留中の要求から新しい判断を構成します。exchange start --replaces <hash> ... は、観測された nonce で新たにサポート対象の取引を選択します。どちらも保存済みの要求を再送するものではなく、承認や取り込みを保証するものでもありません。
• littlejohn-mcp activity get <hash> --address <address> と activity list --address <address> は、ローカルの記録のみを読み取ります。activity inspect <hash> --address <address> は、有限の待機時間内でチェーンを明示的に再確認します。

必要なトークンまたはルーターの各アローワンスは、それぞれ個別の判断とウォレットへの要求になります。承認を完了しても、次の取引が自動的に送信されることはありません。

ターミナルでの QR コード表示と、現在のプロファイル上の制限については、アーキテクチャに記載されています。littlejohn-mcp wallet connect は、インストール済みパッケージの QR コードレンダラーを使用します。

データに署名する

App 対応の MCP ホストに、指定したメッセージまたは型付きデータの署名判断を作成するよう依頼します。データとドメイン全体を確認してから、直接操作を使い、ウォレットで個別に承認します。検証済みの署名は、その App の結果パネルにのみ表示されます。値全体を選択し、お使いのデバイスのコピーコマンドを使用してください。パネルには「閉じる」操作があります。MCP ホストはこの非公開の結果を確認できます。パネルを閉じても、署名は取り消されず、Little John MCP の外部にあるコピーも消去されません。

CLI の場合は、ペイロードをユーザーが所有する JSON ファイルに入れます。たとえば、次の合成メッセージはアプリケーション上の操作を許可しません。

{"kind":"personal","encoding":"utf8","value":"Little John MCP signing check. This message grants no action."}

littlejohn-mcp signing start --active --file message.json を実行し、y と回答する前に判断内容全体を確認します。出力先も対話型ターミナルである必要があります。address セレクターと、正確な読み取り／破棄の構文については、littlejohn-mcp --help に記載されています。16 進数のメッセージでは "encoding":"hex" を明示的に指定します。0x で始まるテキスト値はテキストのまま扱われます。型付き入力では、"kind":"typed_data" と types、primaryType、domain、message を使用します。整数値は正確な 10 進文字列で指定します。EIP712Domain を明示的に宣言し、異なるメッセージ型を使用します。指定するドメインのチェーンは Robinhood Chain である必要があります。

既存の送信専用セッションで署名メソッドを追加するには、明示的な切断／接続の承認が必要です。権限が不足していても、自動的に再接続されることはありません。この機能は署名をサービスに送信したり、トランザクションをブロードキャストしたり、台帳エントリーを作成したりしません。検証プロファイルは 65 バイトの secp256k1 署名です。コントラクトアカウントの署名検証には対応していません。遅れて届いた応答は破棄され、配信状況が不明でも再度リクエストが送信されることはありません。署名キャッシュ、永続的な署名記録、後から署名を取得するコマンドはありません。CLI のスクロールバックと、ユーザーが所有する入力ファイルやコピーは、製品による破棄管理の対象外です。署名権限の正確な内容と結果の意味については、トランザクションポリシーを参照してください。

結果とローカル状態

返されたハッシュは、実行が成功したことを意味しません。記録では、成功して取り込まれたもの、リバート、保留中と確認されたもの、見つからないもの、読み取りできないものを区別します。実際のリクエストと効果の比較は、実行ステータスとは別に扱われます。証拠が欠けている場合、一致した結果とは見なされません。リバートでもガスは消費されます。

待機を停止しても、送信済みの Wallet リクエストはキャンセルできません。元の有効期間内にハッシュが後から確認された場合、新たなネットワーク照会を行わずに記録されます。明示的な照会や後続のトランザクションコマンドで、既知のハッシュを照合できます。タイマー、再起動、承認の完了によって、金融リクエストが再送されることはありません。

トランザクションの判断、署名されていないリクエスト、権限付与は一時的なメモリーに保持されます。実行台帳は、ハッシュと送信前の比較用参照を受け取った時点でのみ開始されます。再利用可能なトランザクションや Review 全体ではなく、実際の結果を保存します。保存済みのトランザクションカードには、終了状態や結果を表示できますが、期限切れまたは消費済みの判断、リクエスト、権限付与は復元されません。無関係な読み取りスナップショットと永続的な Wallet 管理操作には、それぞれ独自の有効期間があります。

保持されるトランザクション、カード、変更不可能な結果の履歴には、合計行数やバイト数の上限がなく、自動削除もされません。ディスク使用量が増える可能性があります。実際の書き込みに失敗した場合、先行して確定済みの値は保持されます。大きな MCP 読み取りでは、切り詰めずに保存済みのソースをそのまま返します。メタデータと上限のある結果パーツには元のバイト列が保持されます。一部のデータだけが配信されても、完全な結果ではありません。データを読み取っても、判断が開始されたり Wallet リクエストが承認されたりすることはありません。

デフォルトのプロファイル保存場所は、オペレーティングシステムのアプリケーション状態ディレクトリに準じます。所有者のみがアクセスできるファイルには、製品データベース、独立した WalletConnect 復元ストア、ローカル制御用の認証情報が含まれます。互換性のないプロファイルを自動移行の対象と見なしたり、起動エラーを回避するためだけに消去したりしないでください。

権限と結果の正確な意味は、 トランザクションポリシーで定義されています。サードパーティの告知とライセンスは、配布パッケージに含まれています。

Little John MCP のソースライセンスはMITです。 依存関係には、それぞれ個別の条件が適用されます。サードパーティの告知 およびライセンスを参照してください。 WalletConnect Community License も含まれます。