Tetrees MCP

Tetrees Agent EX

ホスト型の Tetrees Agent MCP と API を通じて Tetrees AI Packs を利用、育成、購入、公開するための公開統合キットです。

[](https://mcpqueen.com/s/ai.tetrees.ex/mcp)

Tetrees AI Packs を見る  ·  MCP 経由で接続  ·  AI Pack を公開

このリポジトリは、公開製品 @tetrees/mcp（ai.tetrees/mcp）です。stdio MCP サーバー、クライアント、設定例、安全な拡張サンプルが含まれています。Tetrees Agent の内部実装、非公開の Pack インテリジェンス、Agent AVCP のスコアリング、サービスプロンプト、ストレージ、モデレーション、取引所のインフラストラクチャは含まれていません。

構築できるもの

用途	このキットでできること
購入者／オペレーター	Pack を検索し、公開されている Agent AVCP レポートを確認し、実行料金を見積もり、Tetrees Points を使って Pack を試し、無料 Pack を入手し、所有する .taip リリースをダウンロードできます。
開発者	認証情報をローカルに保持したまま、試用済みの Pack をユーザー所有の HTTPS API、ネストされた MCP サーバー、またはシェルを使わないローカルスキルに接続できます。
販売者	リスティングを作成し、不変の .taip バージョンと画像をアップロードし、準備状況を確認し、Agent AVCP を実行し、非公開の修正フィードバックを読み、合格したリリースを公開できます。

Tetrees のホスト型サービスを利用するのに、ローカル GPU は不要です。モデルを使用する実行は、開始前に Tetrees Points で見積もられます。所有する Pack では、ローカル MCP プロセスに指定したサポート対象プロバイダーのキーも使用できます。

クイックスタート：ホスト型 MCP

要件：Node.js 20 以降と、Tetrees Account で発行した取り消し可能な API トークン。

MCP クライアントの設定に次の内容を追加します。

{
  "mcpServers": {
    "tetrees-ai": {
      "command": "npx",
      "args": ["-y", "https://ex.tetrees.ai/pkg/tetrees-mcp.tgz?v=2.2.1"],
      "env": {
        "TETREES_API_URL": "https://ex.tetrees.ai/api",
        "TETREES_TOKEN": "<revocable-account-token>"
      }
    }
  }
}

MCP クライアントを再起動してから、次のように依頼します。

Search Tetrees AI Packs for repository issue triage. Show the public Agent AVCP
report and runtime profile for the best match, then quote an 8k/2k Point-funded
run. Do not run it until I approve the quoted maximum.

プロバイダーキーを Pack、プロンプト、ソースファイル、共有 MCP 設定に含めないでください。オプションの BYOK キーは、ローカル MCP プロセスの環境にのみ指定してください。詳しくは examples/mcp/mcp-config.jsonc を参照してください。

MCP コントラクトを確認する

npm install
export TETREES_TOKEN="txk_..."
npm run mcp:inspect

インスペクターは公式のホスト型 MCP パッケージを起動し、公開ツールとリソースを一覧表示して、購入者／開発者／販売者向けの想定インターフェースを確認した後、Points を消費したりアカウントの状態を変更したりせずに終了します。

v=2.2.1 のサフィックスは意図的なものです。同じ URL でキャッシュされた古い MCP tarball が npx に再利用されないようにします。Tetrees が新しい MCP コントラクトを公開した場合にのみ変更してください。同じパッケージの npm 上の識別子は @tetrees/[email protected] です。

公開 API CLI

このプロジェクトではシークレットファイルを自動で読み込まないため、.env.example の値をシェルにコピーしてください。

export TETREES_TOKEN="txk_..."

# Read-only calls
npm run tetrees -- status
npm run tetrees -- catalog "research"
npm run tetrees -- models
npm run tetrees -- skills
npm run tetrees -- owned
npm run tetrees -- runtime <pack-id>
npm run tetrees -- report <pack-id>

# Quote first. This never starts a model request.
npm run tetrees -- quote <pack-id> <model-id>

# A Point-spending run needs the exact confirmation flag.
npm run tetrees -- run <pack-id> <model-id> "Your task" --confirm-spend

CLI はシークレットらしいレスポンスフィールドをマスクし、Tetrees のエラーコード、HTTP ステータス、Retry-After を報告します。変更操作を自動で再試行することはありません。

購入者のフロー

1. Pack を検索します。
2. 公開されている Agent AVCP レポートとランタイムプロファイルを確認します。
3. 使用するモデル、トークン上限、ホスト型スキル、育成チェックポイントを正確に見積もります。
4. Points を使用するステートレスなプレビューを実行します。未使用の予約済み Points は返却されます。
5. Tetrees EX で無料 Pack を入手するか、有料 Pack を購入します。
6. 所有権を得ると、ダウンロード、BYOK、育成データの保存、クライアント拡張が利用可能になります。

ドキュメントに記載された読み取り専用の例を実行します。

node examples/buyer/discover-and-quote.mjs "incident response"

ビルダーのフロー：Tetrees に機能を提供せずに追加する

公開済みの Pack では、Agent AVCP に合格したクライアント拡張機能を宣言できます。実際のバインディングと認証情報は、ユーザーのマシン上に保持されます。

サポートされているバインディングパターン：

• https_api：固定の HTTPS ベース URL、宣言されたメソッド、環境変数に基づくヘッダー。
• mcp：シェルを介さずに起動するネストされた MCP サーバー。宣言されたツール名にマッピングされます。
• local_skill：シェルを介さず、1 件の JSON リクエストを受け取り、1 件の JSON 結果を返す子プロセス。

まず、以下を確認してください。

• examples/extensions/client-extensions.example.json
• examples/extensions/local-skill/issue-summary.mjs
• docs/BUILDER_GUIDE.md

Tetrees のホスティングで、これらのローカル権限が引き継がれることはありません。書き込みメソッドには、呼び出しごとに正確なフレーズ APPROVE extensionId.methodId が必要です。

販売者のフロー

サポートされている公開者向けの手順は、意図的にコントラクト主導になっています。

# Read-only readiness/report inspection
node examples/seller/check-readiness.mjs <pack-id>

# Upload one higher immutable version. Requires explicit confirmation.
node examples/seller/upload-pack.mjs <pack-id> 1.1.0 ./release.taip --confirm-upload

次に、ホストされた MCP ツールまたは Tetrees API リファレンスを使用して、送信、Agent AVCP の見積もり、正確な Point 額を確認したうえでの実行、非公開レポートの確認を行い、合格したダイジェストのみを公開してください。

docs/SELLER_GUIDE.md と examples/seller/pack-listing.example.json を参照してください。

安定した公開リファレンス

• MCP ガイド
• API ドキュメント
• OpenAPI 3.1
• Postman コレクション
• AI Pack カタログ

セキュリティと製品の境界

このリポジトリには、以下は含まれません。

• Tetrees Agent の実装、非公開 Pack の内容、メモリ表現、成長ロジック。
• Agent AVCP のスコアリングルール、内部評価用フィクスチャ、サービスプロンプト、モデレーションロジック。
• モデルプロバイダーの認証情報、価格マージン、署名キー、ストレージの詳細、データベース、管理 API、デプロイコード、本番環境の設定。

例では、ドキュメントに記載された公開済みの認証付きコントラクトのみを使用します。貢献する前に、SECURITY.md と docs/PUBLIC_BOUNDARY.md を確認してください。

このリポジトリを検証する

npm test
npm run check:public-boundary
npm pack --dry-run

ライセンス

このリポジトリのクライアントの例とドキュメントは、MIT ライセンスで提供されます。Tetrees、Tetrees Agent、Tetrees AI Pack、TAIP、および Agent AVCP の名称とサービスマークは、引き続き Tetrees EX の所有物です。このライセンスは、ホストされたサービスまたは非公開 Pack のインテリジェンスへのアクセスや権利を付与するものではありません。