twinlens

twinlens

レンズとは、オーナー自身の資料をもとに引用付きで質問に答える、公開 AI ページです。twinlens は、ホスト型レンズサービスへの小さな転送クライアントです。プロフィールからレンズを作成し、未登録のレンズにナレッジを追加して、取り込み状況を報告します。

デフォルトでは匿名で作成され、アカウントもトークンも必要ありません。匿名で作成したレンズは共有 URL ですぐに公開され、後から請求 URL を通じて所有権を取得できます。所有権が取得されない場合は、30 日後に期限切れになります。アカウントをお持ちの場合は、MINDOLA_SESSION_TOKEN を設定すると Bearer トークンとして送信され、レンズはそのアカウントに直接作成されます。MINDOLA_MCP_URL を使ってエンドポイントを変更できます（デフォルトは https://app.mindola.ai/mcp/lens）。

作成時のエチケット（仕様の一部）： 作成を呼び出す前に、提案するプロフィールを要約し、ユーザーから明示的な確認を得てください。また、ユーザーが提供または確認した情報のみを含めてください。推測でプロフィールを補完しないでください。

CLI

npx @reneturcios/twinlens create '{"displayName":"Ada Example","tone":"warm","facts":["Works on compilers"]}'
npx @reneturcios/twinlens add-knowledge '{"lens_token":"abc123","items":[{"type":"text","content":"A note","title":"Note"}]}'
npx @reneturcios/twinlens status abc123
npx @reneturcios/twinlens --version

create はプロフィールを 1 つの JSON オブジェクトとして受け取ります（すべてのフィールドは省略可能です）。add-knowledge は同様に {lens_token, items} を受け取ります。status は共有 URL の /me/ 以降の部分である共有トークンを直接受け取ります。

終了コード：成功時は 0、実行時エラー時（上流からの拒否、例：所有権取得済みのレンズへのナレッジ追加を含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/twinlens mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "twinlens": {
      "command": "npx",
      "args": ["-y", "@reneturcios/twinlens", "mcp"]
    }
  }
}

ツール

• create_digital_twin_lens — ユーザーが確認したプロフィールからレンズを作成します。すべてのフィールドは省略可能です：displayName（80 文字以下）、tagline、bio、context、audience（500 文字以下）、sourceSummary、topicName（80 文字以下）、locale（BCP-47）、tone（warm | neutral | professional | playful）、accentColor、expertise（string[]）、boundaries（string[]）、facts（string[]、30 件以下）、suggestedPrompts（string[]、4 件以下）、vibeWords（string[]、4 件以下）。結果は structuredContent から読み取ります：shareUrl、claimUrl、manageUrl、claimRequired、expiresAt、factCount。
• add_lens_knowledge — 未登録のレンズに最大 20 件の項目を追加します。lens_token（string、必須）、items（必須）：各項目は {type: "text" | "url", content (≤20000 chars), title? (≤80 chars)} です。項目はバックグラウンドで取り込まれます。
• get_lens_status — lens_token（string、必須）。claimed とナレッジの合計（total、ready、pending、failed）を報告します。ナレッジを追加した後、pending が 0 になるまでこのツールでポーリングしてください。

Docker

docker run -i ghcr.io/cloudcorprecords/twinlens
docker run --rm ghcr.io/cloudcorprecords/twinlens status abc123

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios