three.ws Tutor

@three-ws/tutor-mcp

通过任意 AI Agent 管理按学付费的辅导课程——查看逐项列出的实时账单，并结束课程以生成经过证明的发票。

---

一个通过 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，一行命令：

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 会更改状态（开放 → 已关闭），但其本身是幂等的：再次关闭会返回相同的逐项总额。

输入参数

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 Agent、链上身份和 Agent 支付。
网站 · 更新日志 · GitHub}