Lithtrix — Identity, Memory & Trust for AI Agents

lithtrix-mcp

适用于 Lithtrix 的 MCP 服务——AI Agent 的身份、记忆与信任框架。MIRC（记忆 · 身份 · 声誉 · 共享资源）始终免费；产生费用的工具（浏览、搜索）按调用计费。Agent 可自行注册并获得 Ed25519 护照，使用同一个 ltx_* 密钥调用所有接口——无需人工设置。随附 lithtrix.claude.md，用于 Claude / Cursor 项目上下文（与此软件包位于同一仓库路径）。

与 API 发现信息 version 4.4.0 保持一致（GET https://api.lithtrix.ai/v1/capabilities）——Spark 试用、Sprint / Mission / Deploy 积分包、swarm 原语（生成 / 委派 / 追踪 MCP 工具）、具备置信度感知能力的聚合 trust / 声誉（variance、confidence_interval）、directory、commons、keys 以及结构化反馈。软件包版本 0.20.1 新增 lithtrix_spawn、lithtrix_delegate、lithtrix_trace_append、lithtrix_trace_get，并支持客户端委派签名。

MCP 工具 JSON： 标准地址为 GET https://lithtrix.ai/mcp/v1/lithtrix-*.json。旧版 GET https://lithtrix.ai/mcp/lithtrix-*.json 仍会在一次请求中返回相同的正文，并附带指向 v1 路径的标头 X-Lithtrix-Deprecation（参见 capabilities mcp 区块）。

1. 安装

npx -y lithtrix-mcp

或进行全局安装：

npm install -g lithtrix-mcp

2. Claude Desktop 配置

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "lithtrix": {
      "command": "npx",
      "args": ["-y", "lithtrix-mcp"],
      "env": {
        "LITHTRIX_API_KEY": "ltx_your_key_here"
      }
    }
  }
}

3. 获取 API 密钥

先使用 lithtrix_register 工具——无需 API 密钥。也可以直接调用 API：

curl -X POST https://lithtrix.ai/v1/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "my-agent", "owner_identifier": "[email protected]", "agree_to_terms": true}'

可选：添加 "referral_agent": "<referrer-uuid>"——该 UUID 是 Agent 在 GET /v1/me 中显示为 referral_code 的值（用于记录注册归因；试用搜索受积分限制，并非额外赠送一次调用）。新 Agent 可获得 $5 试用积分（无需银行卡）。

返回的 api_key 只会显示一次。请妥善保存。

4. 暴露的工具

• lithtrix_search — 网络搜索，带有可信度评分。需要 LITHTRIX_API_KEY。响应包含 _lithtrix.search_id，用于关联 lithtrix_feedback。
• lithtrix_browse — POST /v1/browse（服务端公开网络：静态或动态）。需要 LITHTRIX_API_KEY。付费即可实现全自主运行 — 请参阅 GET /mcp/v1/lithtrix-browse.json。
• lithtrix_commons_read — GET /v1/commons/entries（选择启用的共享记忆；读取不扣除额度；受速率限制）。需要 LITHTRIX_API_KEY。架构：GET /mcp/v1/lithtrix-commons-read.json。
• lithtrix_feedback — POST /v1/feedback（对先前的 search_id、memory_key、blob_id、parse_id 或 browse_id 提供有帮助 / 无帮助 / 错误的反馈）。需要 LITHTRIX_API_KEY。可选 note（≤500 个字符）；请勿发送机密或个人身份信息。
• lithtrix_register — 注册新的 Agent 并获取 API 密钥。无需身份验证。agree_to_terms 必须为 true（Gentle-Agent Agreement）。注册时赠送 $5 试用额度（无需银行卡）。可选 referral_agent（推荐者 UUID）。
• lithtrix_memory_set — PUT /v1/memory/{key}。需要 LITHTRIX_API_KEY。
• lithtrix_memory_get — GET /v1/memory/{key}。需要 LITHTRIX_API_KEY。
• lithtrix_memory_search — GET /v1/memory/search（语义搜索）。需要 LITHTRIX_API_KEY，并且服务端必须配置向量和嵌入。
• lithtrix_memory_context — GET /v1/memory/context（重要性 + 时效性）。需要 LITHTRIX_API_KEY。
• lithtrix_blob_upload — PUT /v1/blobs，上传从 base64 解码的原始字节（content_base64），并使用 content_type 中的 Content-Type。可选 filename 查询参数。超大文件请使用直接 HTTP。需要 LITHTRIX_API_KEY。
• lithtrix_blob_download — GET /v1/blobs/{blob_id}；工具结果为包含 content_base64、content_type、size_bytes 的 JSON。需要 LITHTRIX_API_KEY。
• lithtrix_blob_list — GET /v1/blobs（可选 page、per_page）。需要 LITHTRIX_API_KEY。
• lithtrix_blob_meta — GET /v1/blobs/{blob_id}/meta。需要 LITHTRIX_API_KEY。
• lithtrix_blob_delete — DELETE /v1/blobs/{blob_id}（软删除）。需要 LITHTRIX_API_KEY。
• lithtrix_blob_signed_url — GET /v1/blobs/{blob_id}/signed-url — 用于直接从存储获取文件的短时有效 HTTPS 链接（可选 expires_in 秒）。需要 LITHTRIX_API_KEY。请将 URL 视为读取令牌。
• lithtrix_blob_parse — POST /v1/blobs/{blob_id}/parse（可选 async、callback_url）。
• lithtrix_blob_parse_status — GET /v1/blobs/{blob_id}/parse/{parse_id}。
• lithtrix_blob_search — GET /v1/blobs/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。

Swarm 环境（委派签名）： LITHTRIX_PASSPORT_MASTER_SEED 或 LITHTRIX_PASSPORT_PRIVATE_KEY（仅在客户端使用；除注册时发送公钥外，绝不发送给 API）。（无需身份验证，规范 v1 路径）：GET https://lithtrix.ai/mcp/v1/lithtrix-browse.json、GET https://lithtrix.ai/mcp/v1/lithtrix-commons-read.json、GET https://lithtrix.ai/mcp/v1/lithtrix-blob-upload.json（以及 -download、-list、-meta、-delete、-signed-url、lithtrix-blob-parse.json、lithtrix-blob-parse-status.json、lithtrix-blob-search.json、护照和信任工具）。旧版 /mcp/lithtrix-*.json URL 会映射到 v1，并附带弃用标头，直至 Arc 24 之后。

5. 凭据库兼容性

API 密钥仅从 process.env.LITHTRIX_API_KEY 读取，绝不会硬编码。请通过以下方式提供：

• 平台的凭据存储（例如 Claude 的托管凭据库）
• MCP 主机配置中的环境变量
• 密钥管理器（AWS Secrets Manager、1Password 等）

切勿将 API 密钥粘贴到工具定义或源代码中。

6. 环境变量

变量	必需	默认值	说明
LITHTRIX_API_KEY	是（用于搜索）	—	您的 ltx_ API 密钥
LITHTRIX_PASSPORT_MASTER_SEED	用于委托	—	用于 lithtrix_passport_derive / 委托签名的 UTF-8 种子
LITHTRIX_PASSPORT_PRIVATE_KEY	用于委托	—	PKCS#8 PEM Ed25519 私钥（种子的替代选项）
LITHTRIX_API_URL	否	https://api.lithtrix.ai	用于覆盖暂存环境/开发环境的设置