Touchstone

touchstone-mcp

Touchstone 用のローカル MCP サーバーです。Touchstone は、エージェントの実行内容を改ざん検知可能で、外部にアンカーされたログに記録します。

このサーバーはあなたのマシン上で動作し、あなたの Ed25519 署名キーを保持します。各イベントにローカルで署名し、レコーダーに追記するため、エージェントは touchstone_record({ event_type, payload }) を呼び出すだけで済みます。キーがこのプロセスの外に出ることはありません。 正規化（JCS / RFC 8785）もローカルで行うため、悪意のあるサーバーや侵害されたサーバーに、意図したものとは異なるコミットメントへの署名を強制されることはありません。

依存関係はゼロで、Node 18+ の組み込み機能のみを使用します。単一ファイルなので、信頼する前に内容を確認できます。

リモート MCP（https://touchstone.cv/mcp）はあなたに代わって署名できません（Touchstone がキーを保持することはありません）。そのため、リモート MCP の touchstone_record には、自分で計算した署名が必要です。手間のかからないローカル署名を使う場合は、このサーバーを実行してください。

インストール

# one-off, no install:
npx -y @touchstone-cv/mcp

# or vendor the single file:
curl -O https://touchstone.cv/touchstone-mcp.mjs

# or clone:
git clone https://github.com/Touchstone-CV/touchstone-mcp && cd touchstone-mcp

設定

stdio 経由で MCP クライアントから接続します。

{
  "mcpServers": {
    "touchstone": {
      "command": "npx",
      "args": ["-y", "@touchstone-cv/mcp"],
      "env": {
        "TOUCHSTONE_RECORDER": "rec_...",
        "TOUCHSTONE_SUBJECT": "<your-colony-sub>",
        "TOUCHSTONE_API_KEY": "tsk_...",
        "TOUCHSTONE_SIGNING_KEY": "<base64 Ed25519 32-byte seed>"
      }
    }
  }
}

環境変数	必須	意味
TOUCHSTONE_RECORDER	はい	レコーダーの公開 ID（rec_…）
TOUCHSTONE_SUBJECT	記録する場合	Colony の sub — レコーダーのサブジェクト
TOUCHSTONE_API_KEY	はい	レコーダー上で発行された API キー（tsk_…）
TOUCHSTONE_SIGNING_KEY	記録する場合	base64 形式の Ed25519 32 バイトシード — あなたが保持し、送信されることはありません
TOUCHSTONE_KEY_FILE	代替	インラインシードの代わりに使用する JSON {"seed_b64":"…"} のパス
TOUCHSTONE_BASE_URL	いいえ	デフォルトは https://touchstone.cv

レコーダーとキーの取得方法については、touchstone.cv/developers をご覧ください。エージェントは自身の Colony トークンを使って、ブラウザーなしでレコーダーをセルフプロビジョニングできます（OAuth Token Exchange、RFC 8693）。

ツール

ツール	機能
touchstone_record	payload を JCS で正規化し、コミットメントにローカルで署名して、エントリーを追記します
touchstone_disclose	共有可能な /d/<token> 開示リンクを作成します（サービスにプロキシします）
touchstone_verify	開示バンドルを検証します（サービスにプロキシします）
touchstone_recorder_info	レコーダーの公開情報とチェックポイントの状態を取得します

署名キーを使用するのは touchstone_record のみです。それ以外は、あなたの API キーを使ってリモートサービスにプロキシします。

フィールドの選択的開示

touchstone_record({ event_type, payload, selective_disclosure: true }) を呼び出すと、各 payload フィールドを個別にコミットします。クライアントはローカルでソルト付きフィールドの Merkle ルートを計算し、それを payload_hash として署名して、フィールドごとのソルトを保存します。後から一部のフィールドだけを開示できます。

touchstone_disclose({ seqs: [n], reveal: { n: ["field_a", "field_b"] } })

開示されたフィールドには、payload_hash（すでにあなたの署名で保護されています）に対する Merkle 証明が含まれます。非開示のフィールドはソルトに紐付けられ、その値が開示に現れることはありません。ルートの計算結果は、サーバーおよび検証ツールとバイト単位で一致します。

ログの検証

開示は、Touchstone を信頼することなく誰でも確認できます。ブラウザー検証ツール、スタンドアロンの verify.php、またはスプリットビュー検出ツールの gossip_check.py で検証できます。これらのツールはサイトから配信され（それぞれ監査可能な単一ファイルです）、このリポジトリには記録用クライアントのみが含まれています。

ライセンス

Apache-2.0。