Luxxon

Luxxon — TypeScript SDK + MCP サーバー

AI エージェントのためのプログラム可能なビジョンです。実世界の場所からライブ動画または単一フレームをリクエストし、USDC でオンチェーン決済できます。

このリポジトリには、次のものが含まれています。

パッケージ	目的
packages/sdk	Luxxon API 用の TypeScript HTTP クライアントです。純粋な fetch を使用し、ネイティブ依存関係はありません。
packages/mcp	Luxxon をエージェントから呼び出せるツールとして公開する MCP サーバーです（stdio トランスポートを使用し、Claude Desktop／Cursor／あらゆる MCP クライアントで動作します）。
examples/	実行可能なエージェントの例です。コピーして貼り付け、実行できます。

API：docs.luxxon.dev — https://api.luxxon.dev/api/v1。

MCP サーバーを使う理由

エージェントが使えるのは fetch() であり、<video> タグではありません。MCP サーバーによって、Luxxon は MCP 対応エージェントが直接呼び出せる一連のツールになります。

• get_frame(sessionId) → ビジョンモデルですぐに使える JPEG バイト列
• get_session(sessionId) → ライブセッションの現在の状態
• cancel_session(sessionId) → 早期終了

サーバーを Claude Desktop の設定に追加すれば、エージェントが世界を見られるようになります。

クイックスタート — TypeScript SDK

import { Luxxon } from "@luxxon/sdk";

const lx = new Luxxon({ apiKey: process.env.LUXXON_API_KEY });

// Read the latest frame from a LIVE session (returns a Buffer).
const jpeg = await lx.sessions.frame("sess_abc123");

クイックスタート — MCP サーバー

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "luxxon": {
      "command": "npx",
      "args": ["-y", "--package=@luxxon/mcp", "luxxon-mcp"],
      "env": { "LUXXON_API_KEY": "lxxn_live_..." }
    }
  }
}

Claude Desktop を再起動すると、「Luxxon」の下に 3 つのツールが表示されます。

ステータス

v0。公開しながら開発中です。SDK と MCP は現在、エージェントが読み取る機能（フレーム、セッションの状態、キャンセル）をカバーしています。セッションの作成は、現在も API 側で構築中のカストディアルウォレットによる署名フローに依存しています。現時点では、REST API を使って自分でセッションを作成し、この SDK／MCP で利用してください。

パブリック開発コンソールと Python／Go／CLI SDK も今後公開予定です。このリポジトリをチェックしてください。