lithtrix

lithtrix-mcp

Lithtrix 向け MCP サーバー — AI エージェントのためのアイデンティティ、メモリー、信頼のハーネスです。MIRC（メモリー・アイデンティティ・レピュテーション・コモンズ）は常に無料です。料金が発生するツール（Browse、検索）は呼び出しごとに従量課金されます。エージェントは自分で登録して Ed25519 パスポートを受け取り、同じ ltx_* キーですべての機能を呼び出せます。人によるセットアップは不要です。Claude／Cursor のプロジェクトコンテキスト用に lithtrix.claude.md が同梱されています（このパッケージと同じリポジトリパスにあります）。

API の検出結果 version 4.4.0（GET https://api.lithtrix.ai/v1/capabilities）に準拠しています — Spark トライアル、Sprint / Mission / Deploy クレジットパック、swarm プリミティブ（MCP ツールの spawn／delegate／trace）、信頼度を考慮した集計 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 も引き続き同じ内容を返しますが、1 アークの間、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>" を含めます — これは、GET /v1/me で referral_code として表示される同じ UUID です（登録元の識別情報として保存されます。トライアルでの検索はクレジット制であり、呼び出し回数のボーナスはありません）。新しいエージェントには $5 分のトライアルクレジットが付与されます（カード不要）。

返された api_key は一度だけ表示されます。安全に保管してください。

4. 公開されるツール

• lithtrix_search — 信頼性スコア付きのウェブ検索です。LITHTRIX_API_KEY が必要です。レスポンスには、lithtrix_feedback と関連付けるための _lithtrix.search_id が含まれます。
• 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 — 新しいエージェントを登録し、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 — base64 からデコードした生バイト列（content_base64）と、content_type から取得した Content-Type を使って PUT /v1/blobs を実行します。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 — ストレージから直接 GET するための有効期間の短い 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、passport および trust ツール）。レガシーの /mcp/lithtrix-*.json URL は、Arc 24 以降まで非推奨化ヘッダー付きで v1 にエイリアスされます。

5. 認証情報保管庫との互換性

API キーは process.env.LITHTRIX_API_KEY からのみ読み込まれます。ハードコードされることはありません。次の方法で渡してください。

• お使いのプラットフォームの認証情報ストア（例：Claude の管理対象認証情報保管庫）
• MCP ホスト設定の環境変数
• シークレットマネージャー（AWS Secrets Manager、1Password など）

API キーをツール定義やソースコードに貼り付けないでください。

6. 環境変数

変数	必須	デフォルト	説明
LITHTRIX_API_KEY	はい（検索の場合）	—	お使いの ltx_ API キー
LITHTRIX_PASSPORT_MASTER_SEED	delegate の場合	—	lithtrix_passport_derive／delegate の署名に使う UTF-8 シード
LITHTRIX_PASSPORT_PRIVATE_KEY	delegate の場合	—	PKCS#8 PEM Ed25519 秘密鍵（シードの代替）
LITHTRIX_API_URL	いいえ	https://api.lithtrix.ai	ステージング／開発環境向けの上書き設定