Luxxon

Name: Luxxon
Author: daniel-underpass

本地服务

github.com/daniel-underpass开发工具124 周前更新

代码仓库

关于 Luxxon

Luxxon 提供 TypeScript SDK 和 MCP 服务，让 Agent 获取真实地点的实时视觉数据。它支持读取 JPEG 画面和控制已有会话；SDK 和 MCP 服务目前不支持创建会话。

主要功能

01从会话获取 JPEG 画面
02查看实时会话状态
03提前取消会话
04使用 fetch 的 TypeScript HTTP SDK

适用场景

01向视觉模型提供会话画面
02确认实时会话是否运行
03提前停止现有会话

MCP 相关

提供获取会话画面、查看状态和取消会话的工具。目前需通过 REST API 创建会话。

#vision #video #webrtc #ai-agents #base #usdc #on-chain #jpeg #llm #mcp #claude #cursor

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "luxxon-sdk": {
      "command": "npx",
      "args": [
        "-y",
        "luxxon-mcp"
      ],
      "env": {
        "LUXXON_API_KEY": "<LUXXON_API_KEY>"
      }
    }
  }
}

启动命令npx -y luxxon-mcp

需要配置的环境变量

LUXXON_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmluxxon-mcpstdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
lat	number	是	要观察点的 WGS84 纬度（十进制度）
lng	number	是	要观察点的 WGS84 经度（十进制度）
maxDurationSeconds	number	是	会话时长上限，单位为秒。计量会在 /end 或达到此时长时停止，以先发生者为准。
quoteId	string	否	可选的 get_pricing_quote 返回的 quoteId，用于锁定费率。不提供时，将使用创建时的即时费率。
timeoutMs	number	否	等待操作员进入 LIVE 状态的最长时间（毫秒）。默认值为 30000。如果操作员在此时间内未进入 LIVE，将返回 sessionId 和当前状态而非报错；继续等待请使用 wait_for_live，放弃请使用 cancel_session。

详细介绍

Luxxon — TypeScript SDK + MCP 服务

面向 AI Agent 的可编程视觉。请求真实地点的实时视频或单帧画面，并使用 USDC 在链上结算。

此仓库包含：

软件包	用途
`packages/sdk`	Luxxon API 的 TypeScript HTTP 客户端。纯 `fetch`，无需原生依赖。
`packages/mcp`	将 Luxxon 封装为 Agent 可调用工具的 MCP 服务（stdio 传输，可与 Claude Desktop / Cursor / 任何 MCP 客户端配合使用）。
`examples/`	可运行的 Agent 示例 — 复制、粘贴、运行。

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

为什么需要 MCP 服务

Agent 可以使用 fetch()，却不能使用 <video> 标签。MCP 服务将 Luxxon 转换为一组任何支持 MCP 的 Agent 都能直接调用的工具：

get_frame(sessionId) → 可直接交给视觉模型的 JPEG 字节
get_session(sessionId) → 实时会话的当前状态
cancel_session(sessionId) → 提前终止

将该服务添加到 Claude Desktop 配置中，Agent 就能看见世界。

快速开始 — 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”下方会显示这三个工具。