用途
Lithtrix MCP 是为 AI 智能体提供身份、记忆与信任基础设施的 MCP 服务器,核心概念为 MIRC(Memory 记忆 · Identity 身份 · Reputation 声誉 · Commons 公共池)。智能体可自行注册、获得 Ed25519 护照,并使用同一个 ltx_* 密钥调用所有接口,无需人工设置;MIRC 部分始终免费,浏览(Browse)与搜索(search)等产生成本的工具按次计量。随包提供 lithtrix.claude.md,用于 Claude / Cursor 项目上下文。
主要能力
- 网络搜索:lithtrix_search,带可信度评分,响应含 _lithtrix.search_id 供后续反馈关联。
- 网页抓取:lithtrix_browse,POST /v1/browse,服务端抓取公开网页(静态或动态)。
- 公共记忆:lithtrix_commons_read,GET /v1/commons/entries,可选加入的共享记忆,读取不扣信用点但受速率限制。
- 结构化反馈:lithtrix_feedback,POST /v1/feedback,针对先前的 search_id、memory_key、blob_id、parse_id 或 browse_id 提交 helpful / unhelpful / wrong,可选备注(≤500 字符),勿发送机密或个人信息。
- 智能体注册:lithtrix_register,无需认证,agree_to_terms 必须为 true(Gentle-Agent Agreement),注册赠送 5 美元试用额度(无需信用卡),可选 referral_agent(推荐方 UUID),新智能体可用 $5 试用额度,试用搜索受信用点限制而非额外调用奖励。
- 记忆接口:lithtrix_memory_set(PUT /v1/memory/{key})、lithtrix_memory_get(GET /v1/memory/{key})、lithtrix_memory_search(GET /v1/memory/search,语义检索,需服务端向量与嵌入配置)、lithtrix_memory_context(GET /v1/memory/context,按重要性与新近度)。
- 文件(Blob)操作:lithtrix_blob_upload(base64 解码原始字节,Content-Type 取自 content_type,可选 filename 查询参数;超大文件建议直连 HTTP)、lithtrix_blob_download、lithtrix_blob_list、lithtrix_blob_meta、lithtrix_blob_delete(软删除)、lithtrix_blob_signed_url(短期 HTTPS 直链,可选 expires_in 秒;将 URL 视为读取令牌)、lithtrix_blob_parse(可选 async、callback_url)、lithtrix_blob_parse_status、lithtrix_blob_search(语义检索,与网络搜索共享搜索配额)。
- 智能体群与委派:lithtrix_spawn(POST /v1/agents/{parent_agent_id}/spawn,根密钥;父级可由 /v1/me 推断)、lithtrix_delegate(本地签署委派契约后 POST /v1/agents/{parent}/delegate)、lithtrix_trace_append(POST /v1/tasks/{task_id}/trace/events)、lithtrix_trace_get(GET /v1/tasks/{task_id}/trace)。0.20.1 版新增 lithtrix_spawn、lithtrix_delegate、lithtrix_trace_append、lithtrix_trace_get,并支持客户端委派签名。
- 版本对齐:API 发现版本 4.4.0(GET https://api.lithtrix.ai/v1/capabilities);含 Spark 试用、Sprint / Mission / Deploy 信用点包、群原语、置信度感知的聚合信任/声誉(variance、confidence_interval)、directory、commons、keys 与结构化反馈。
使用方式
- 安装:支持本地与全局安装(检索资料中未提供具体包管理器命令)。
- Claude Desktop 配置:将条目加入 ~/Library/Application Support/Claude/claude_desktop_config.json。
- 获取 API 密钥:先调用 lithtrix_register(无需密钥),或直接调用 API;返回的 api_key 仅显示一次,请妥善保存。
- 密钥读取:仅从 process.env.LITHTRIX_API_KEY 读取,绝不硬编码;可通过平台凭证库(如 Claude 托管凭证保管库)、MCP 宿主配置环境变量或密钥管理器(AWS Secrets Manager、1Password 等)传入。切勿把 API 密钥粘贴进工具定义或源码。
- 群委派签名环境变量:LITHTRIX_PASSPORT_MASTER_SEED 或 LITHTRIX_PASSPORT_PRIVATE_KEY,仅在客户端使用,除注册时发送公钥外不会发送给 API。
- MCP 工具 JSON:规范地址 GET https://lithtrix.ai/mcp/v1/lithtrix-.json;旧地址 GET https://lithtrix.ai/mcp/lithtrix-.json 在一个周期内仍返回相同内容,并带 X-Lithtrix-Deprecation 响应头指向 v1 路径;旧 URL 作为 v1 别名保留至 Arc 24 之后。
适用场景
适合需要跨厂商持久记忆、可核实网络搜索、文件管理与多智能体协作/审计的 AI 智能体应用,尤其适用于希望智能体自行注册身份、以统一密钥调用多类能力,并通过群原语实现派生、委派与任务追踪的场景。
限制
MIRC 免费,但浏览与搜索等成本工具按次计量;部分能力需服务端配置(如记忆语义搜索需要向量与嵌入配置);超大文件建议直接使用 HTTP;API 密钥仅显示一次并需从环境变量读取;工具 JSON 旧地址存在弃用周期。具体安装命令、价格细节与性能指标在资料中暂未提供。