psychosynth

Psychosynth

Psychosynth は、エージェントネイティブなオンチェーン心理測定データマーケットプレイスです。高い分散性を持つ、人間がキュレーションした性格プロファイルと、プロファイルに基づく行動応答を自律システムに提供します。x402 マイクロペイメントプロトコルを使用し、Base 上でクエリごとに USDC で取引を決済します。人間の仲介者は一切必要ありません。

---

システムアーキテクチャ

graph TD
    A["Generator OS (DB Templates)"] --> B["LLM Synthesis (Flash/Sonnet)"]
    B --> C["Hooks Pipeline (validation & dedup)"]
    C --> D["Curation Queue (Review Desk)"]
    D --> E["Supabase DB Store"]
    E --> F["x402 Proxy Middleware (Base)"]
    F --> G["JSON API / MCP Server"]
    G --> H["Autonomous Agents (Eliza, OpenClaw, Hermes)"]

---

主な機能

1. v2 心理測定エンジン

標準的な LLM は「平均モデルバイアス」の影響を受け、ゲームやシミュレーションで均質かつリスク中立的な応答を生成しがちです。Psychosynth は、以下を含む構造化された高分散データセットを提供することで、この問題を解決します。

• 五因子モデル（OCEAN）：開放性、誠実性、外向性、協調性、神経症傾向。
• ダークトライアド特性：マキャベリズム、ナルシシズム、サイコパシー。
• プロスペクト理論の姿勢：損失回避係数（$\lambda$）と、利得（$\alpha$）および損失（$\beta$）に対するべき効用指数。
• 認知的熟考：システム 1（ヒューリスティック主導）とシステム 2（論理的／熟考的）の選好、および認知的熟考テスト（CRT）のスコア。

2. エージェントネイティブな決済（x402）

x402 標準を使用し、Base ブロックチェーン上でクエリごとに取引を決済します。

• ガス代不要の決済：エージェントは EVM ウォレットを使用して、USDC でガス代不要の TransferWithAuthorization ペイロード（EIP-3009）に署名します。
• プロキシミドルウェア：バックエンドが署名を検証し、オンチェーンで決済をブロードキャストして、1 回の HTTP リクエストループ内で要求されたデータセットを配信します。

3. Model Context Protocol（MCP）サーバー

Psychosynth は MCP サーバーを公開し、自律エージェントのランタイムと直接接続できるようにします。

• 対応フレームワーク：ElizaOS、OpenClaw（MCPorter 経由）、Nous Research の Hermes Agent、Virtuals Protocol（G.A.M.E. SDK カスタムアクション経由）。
• 公開ツール：
  • list_products：利用可能な製品、スキーマ、価格を確認します。
  • preview_records：スキーマの形式を確認できる、無料の決定論的なサンプルを取得します。
  • get_quote：取引を実行せずに x402 の支払い見積もりを要求します。
  • query_records：オンチェーン決済を実行し、完全なデータペイロードを取得します。

4. インタラクティブ Lab OS プレイグラウンド

Psychosynth は、人間による操作とデバッグのため、/playground に高級感のあるダークラグジュアリーな金融ダッシュボードを用意しています。

• リアルタイムレーダーチャート：パラメーターの変更に応じて即座に更新される、8 つの心理測定次元（OCEAN、ダークトライアド、プロスペクト理論）を表示する動的な SVG スパイダーマップ。
• ホログラフィック・エージェントパスポート：自動的なアーキタイプ分類と、ワンクリックで直接 Twitter に共有できる、美しく共有可能なグラスモーフィズムの ID カードを生成します。
• マルチエージェント決闘アリーナ：異なるプロファイルを持つ 2 つのエージェント（例：Solana のディジェンとリスク回避型の機関）が取引を交渉するライブシミュレーション空間で、システム 1／2 の推論がリアルタイムでストリーミングされます。
• x402 プロトコルインスペクター：HTTP 402 の支払いチャレンジ、EIP-712 署名、Base ファシリテーターによる決済、ペイロードの復号を段階的に可視化する、インタラクティブなターミナルです。

---

セットアップとインストール

前提条件

• Node.js >= 18
• Supabase CLI（任意。ローカル DB の開発に使用）

クイックスタート

1. リポジトリをクローンし、依存関係をインストールします。

   git clone https://github.com/3esign/psychosynth.git
   cd psychosynth
   npm install
   

2. 環境変数を設定します。

   cp .env.example .env
   # Fill in Supabase keys, X402 payout address, and keys.
   

3. Supabase のマイグレーションをデプロイし、シードデータを投入します。

   npx supabase db push
   # Seeds the base schema and version 2 generators
   

4. Next.js 開発サーバーを起動します。

   npm run dev
   

---

MCP サーバーの設定

MCP サーバーをビルドし（mcp/ 内で npm run build を実行）、MCP クライアントの設定（例：claude_desktop_config.json）に以下のエントリを追加して、エージェントに登録します。お使いのマシン上でビルド済みサーバーの絶対パスを指定してください。

{
  "mcpServers": {
    "psychosynth": {
      "command": "node",
      "args": ["/absolute/path/to/psychosynth/mcp/dist/index.js"],
      "env": {
        "PSYCHOSYNTH_API_URL": "https://psychosynth.vercel.app",
        "BUYER_PRIVATE_KEY": "0xYourBuyerWalletPrivateKey",
        "BASE_RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}

---

CLI とスクリプト

• npm run typecheck — ファイルを出力せずに TypeScript コンパイラのチェックを実行します。
• npm run buyer-test — 実行中のインスタンスに対する有料クエリをエンドツーエンドでシミュレートします。
• npm run export:sft | export:dpo | export:reject-cls — キュレーションデータをトレーニング形式でエクスポートします。

---

ドキュメント

アーキテクチャの詳細仕様、マスタープラン、開発ログは docs/ フォルダーにあります。

• MASTERPLAN.md — プロダクトのビジョンと経済構造。
• DISCOVERY.md — フレームワーク固有のエージェント統合の詳細。
• DEVELOPMENT.md — 詳細なエンジニアリング仕様とデータベーススキーマの設計。

---

エコシステムとプラットフォーム連携

1. Faces Wallet MCP（Buzz by Block と ACP ネイティブ対応）

Psychosynth は、Faces Wallet MCP server を通じて Buzz by Block エージェント（Goose、Codex、Claude Code）と直接連携します。Buzz ワークスペース内のエージェントは、オンチェーンの Base ウォレットを使い、x402_fetch でサイコメトリックデータの x402 クエリを自律的に決済します。

• リポジトリ：https://github.com/3esign/Faces-Wallet-MCP
• 機能：Buzz エージェントは Faces MCP サーバーを読み込み、残高を確認し、設定された支出上限まで、EIP-3009 によるガス代不要の USDC 決済を自動で行って Psychosynth エンドポイントにクエリできます。

2. Bankr エコシステム（x402 ネイティブ対応）

Psychosynth は 標準の x402 に対応しています。エージェントは Base 上でガス代不要の USDC EIP-3009 TransferWithAuthorization に署名し、サーバーは x402 ファシリテーター経由で決済します（ファシリテーターがトランザクションをブロードキャストし、ガス代を負担します）。これは、Bankr プラットフォームのウォレット、x402-fetch、およびほとんどのエージェント用ウォレットレイヤーが自動的に生成する決済形式です。セルフ決済の txHash 決済（Base または Solana）も、フォールバックとして引き続きサポートされています。

• エージェント向け無料の事前確認：GET /api/v1/discovery — プロダクト、最新の価格、ティア、payTo、決済方法を一度の呼び出しで取得できます。
• Bankr スキル：BankrBot/skills カタログへの登録パッケージは integrations/bankr-skills/psychosynth/ にあります（SKILL.md + catalog.json + ロゴ + リファレンス + スクリプト）。マージされると skills.bankr.bot に掲載され、次のコマンドでインストールできます：install the psychosynth skill from https://github.com/BankrBot/skills/tree/main/psychosynth.
• 位置付け：このエコシステムの既存のインテリジェンススキルはトークンを分析します。一方、Psychosynth は合成された行動データ、すなわち市場参加者の行動に関する事前分布を販売しており、トレーディングシミュレーション、取引相手のモデリング、エージェントのストレステストに活用できます。

2. Virtuals Protocol（G.A.M.E. SDK のカスタムアクション）

G.A.M.E. Framework を実行する Virtuals Protocol エージェントは、プロフィールの登録や追加のワーカープロセスのホスティングを行わずに、Psychosynth にネイティブにクエリできます。

• アクションスキーマ：クエリエンドポイントを G.A.M.E. のカスタムアクションにマッピングします。エージェントは自身のオペレーションループに基づいて、必要なデータを判断します。
• 動的な決済：エージェントは、クエリの支払いに使用するガス代不要の EVM TransferWithAuthorization ペイロード（EIP-3009）を構築して署名します。
• シームレスな HTTP 解決：エージェントのツール実行スクリプトが、ペイロードを Vercel API エンドポイントに直接 POST/GET します。トランザクションを検証して決済し、同じレスポンスブロック内でレコードを返します。スキーマペイロードとコードテンプレートについては、API Documentation を参照してください。