three.ws Tutor

@three-ws/tutor-mcp

あらゆる AI エージェントから従量課金制のチューターセッションを管理できます。項目別の利用中の請求額を確認し、セッションを終了して証明付きの請求書を発行できます。

---

stdio 経由で three.ws の 学んだ分だけ支払うチューター台帳 を公開する Model Context Protocol サーバーです。チューターセッションの項目別請求額を確認できます。回答した質問ごとの明細には、項目ごとの費用と累計額が記載されます。セッションを終了すると、証明付きの請求書が確定します。

チューターの料金は回答した質問ごとに発生しますが、このサーバーのツールは無料です。利用中の請求額の確認やセッションの終了によって、学習者に料金が請求されることはありません。学習者が請求額を確認したり、セッションを終了したりするために料金を支払う必要はありません。セッションは不透明な sessionId で識別されるため、API キーも署名者も不要です。THREE_WS_BASE をデプロイ先に設定するだけで利用できます。

インストール

npm install @three-ws/tutor-mcp

または、インストールせずに npx で実行できます。

npx @three-ws/tutor-mcp

クイックスタート

Claude Code の場合は、1 行で設定できます。

claude mcp add tutor -- npx -y @three-ws/tutor-mcp

Claude Desktop / Cursor の場合（claude_desktop_config.json または mcp.json）：

{
	"mcpServers": {
		"tutor": {
			"command": "npx",
			"args": ["-y", "@three-ws/tutor-mcp"]
		}
	}
}

MCP Inspector で機能を確認できます。

npx -y @modelcontextprotocol/inspector npx @three-ws/tutor-mcp

ツール

ツール	種類	説明
load_session	読み取り	sessionId を指定してセッションの項目別の利用中請求額を読み取ります。明細（質問、レベル、トークン数、費用）、ステータス、累計額を返します。
close_session	書き込み	セッションを確定し、証明付きの請求書を返します。SHA-256 証明で台帳を封印し、それ以降の請求をロックします。

どちらのツールも無料で、資金の移動はありません。料金が発生するのは質問への回答であり、その処理は別の場所で行われます。load_session はライブデータを読み取ります。質問への課金に応じて請求額が増えるため、冪等ではありません。close_session は状態を変更します（open → closed）が、それ自体は冪等です。再度終了しても、同じ項目別合計が返されます。

入力パラメーター

load_session — sessionId（必須、100 文字以下）。

close_session — sessionId（必須、100 文字以下）。

使用例

// load_session
> { "sessionId": "learn-abc123" }
{
  "ok": true,
  "sessionId": "learn-abc123",
  "status": "open",
  "createdAt": "2026-06-24T03:40:00.000Z",
  "questionCount": 2,
  "lineItems": [
    { "n": 1, "question": "What is a Solana PDA?", "level": "intro", "outputTokens": 180, "costAtomics": 10000, "costUsd": "0.010000", "at": "2026-06-24T03:41:00.000Z" },
    { "n": 2, "question": "How do CPIs work?", "level": "intro", "outputTokens": 220, "costAtomics": 10000, "costUsd": "0.010000", "at": "2026-06-24T03:42:00.000Z" }
  ],
  "totalAtomics": 20000,
  "totalUsd": "0.020000"
}

// close_session
> { "sessionId": "learn-abc123" }
{
  "ok": true,
  "sessionId": "learn-abc123",
  "createdAt": "2026-06-24T03:40:00.000Z",
  "closedAt": "2026-06-24T03:45:00.000Z",
  "questionCount": 2,
  "lineItems": [ /* same itemized line items */ ],
  "totalAtomics": 20000,
  "totalUsd": "0.020000",
  "attestation": "sha256:…"
}

保存された履歴のない sessionId を指定すると、エラーではなく空のオープンセッション（questionCount: 0）が返されます。これは失敗ではなく、「まだ請求は発生していない」という正確な状態を示します。

要件

• Node.js >= 20。
• https://three.ws（または独自の THREE_WS_BASE）へのネットワークアクセス。

環境変数

変数	必須	デフォルト
THREE_WS_BASE	いいえ	https://three.ws
THREE_WS_TIMEOUT_MS	いいえ	20000

リンク

• ホームページ：https://three.ws
• 変更履歴：https://three.ws/changelog
• 課題：https://github.com/nirholas/three.ws/issues
• ライセンス：Apache-2.0。詳細はLICENSEをご覧ください。

---

_{three.ws SDK スイートの一部です。3D AI エージェント、オンチェーン ID、エージェント決済を提供します。
ウェブサイト · 変更履歴 · GitHub}