three.ws Autopilot

@three-ws/autopilot-mcp

AI Agent 自主执行的专属控制平面——设置自动驾驶范围、每日 SOL 支出上限和自动执行，然后通过任意 MCP 客户端运行提议 → 执行 → 撤销工作流。

---

一个通过 stdio 为 AI Agent 提供专属执行控制平面的 Model Context Protocol 服务。Agent 可配置其获准执行操作的边界——能力范围、每日 SOL 支出上限、自动执行和确认策略——然后驱动完整的提议 → 审核 → 执行 → 撤销工作流。全程无需人工介入，但所有边界都由服务端强制执行：超出范围或超出预算的操作会被拒绝，绝不会执行。

这是自主 Agent 方案的关键一环。自动驾驶配置和执行过去只能通过 three.ws UI/API 使用；此服务将其开放出来，让 Agent 能管理自身的护栏并在其范围内采取行动。

⚠️ 此服务需要身份验证，且以写操作为主。 execute_proposal 可能会在 Solana 主网上转移真实 SOL，而且不可撤销。它只发送原生 SOL——Agent 不会出售或发送 $THREE（只会买入、持有或销毁）。范围、每日 SOL 支出上限和确认机制均由 three.ws 后端强制执行；此服务无法绕过这些限制。

安装

npm install @three-ws/autopilot-mcp

也可以使用 npx 运行（无需安装）：

npx @three-ws/autopilot-mcp

快速开始

Claude Code，只需一行（提供你的 three.ws 凭证）：

THREE_WS_API_KEY=sk_live_… claude mcp add autopilot -- npx -y @three-ws/autopilot-mcp

Claude Desktop / Cursor（claude_desktop_config.json 或 mcp.json）：

{
	"mcpServers": {
		"autopilot": {
			"command": "npx",
			"args": ["-y", "@three-ws/autopilot-mcp"],
			"env": {
				"THREE_WS_API_KEY": "sk_live_…"
			}
		}
	}
}

使用 MCP Inspector 检查可用功能：

THREE_WS_API_KEY=sk_live_… npx -y @modelcontextprotocol/inspector npx @three-ws/autopilot-mcp

身份验证

所有自动驾驶端点都仅限所有者访问，因此此服务需要身份验证。将 Agent 所有者的 three.ws 凭证设置为 THREE_WS_API_KEY——可以是 three.ws API 密钥（sk_live_… / sk_test_…）或 OAuth 访问令牌。每次请求都会通过 Authorization: Bearer … 发送该凭证，用于识别所有者；Agent 只能管理该用户拥有的 Agent。该凭证可通过 execute_proposal 授权执行真实 SOL 转账——请像密码一样妥善保管。THREE_WS_TOKEN 和 THREE_WS_BEARER 也可用作别名。

工具

工具	类型	功能
get_autopilot_config	只读	读取 Agent 的防护措施：是否启用、范围、自动执行、每日 SOL 上限、确认策略，以及信任度。
set_autopilot_config	写入 · 幂等	使用部分补丁更新这些防护措施（授予范围、设置每日 SOL 上限、启用/停用）。不执行任何操作。
generate_proposals	写入	运行 Agent 的思维流程：将高显著性记忆和反思转化为附有来源引用的真实候选操作。
list_proposals	只读	提案队列——包含 ID、类型、理由、参数、状态和引用来源。可按状态筛选。
dryrun_proposal	只读	预览执行提案将会执行的操作（范围/上限/余额检查），但不采取任何操作。
adjust_proposal	写入 · 幂等	在执行前编辑待处理提案的参数（调整阈值、金额、频率）。由服务端验证。
execute_proposal	写入 · 破坏性	执行真实操作。⚠️ wallet_transfer 会在主网上转移真实 SOL，且无法撤销——需要 confirm:true。绝不会发送 $THREE。
dismiss_proposal	写入	丢弃待处理提案；记录一条反馈记忆，让 Agent 不再提出该提案。
undo_action	写入	撤销可逆的执行操作（删除警报规则/简报）；记录一条反馈记忆。SOL 转账无法撤销。
list_autopilot_activity	只读	仅追加的签名回执日志——记录每项自主操作、其结果、来源和签名。
compute_trust	只读	Agent 获得的信任级别（sandbox → trusted → autonomous），根据真实操作历史计算。

五个读取工具反映实时状态（提案、回执、信任度可能在调用之间发生变化），因此都不是幂等的。set_autopilot_config 和 adjust_proposal 是幂等写入（重复应用相同值不会产生变化）。generate_proposals、execute_proposal、dismiss_proposal 和 undo_action 都会执行真实操作。

输入参数

除 list_autopilot_activity 外，每个工具都需要 agentId（你拥有的 Agent 的 UUID）；list_autopilot_activity 的 agentId 为可选参数（省略时会汇总你所有 Agent 的数据）。

• get_autopilot_config / compute_trust / generate_proposals — agentId。
• set_autopilot_config — agentId，以及以下任意参数：enabled（bool）、scopes（{ create_alert?, briefing?, wallet_transfer? }）、autoExecute（{ create_alert?, briefing? }）、dailySpendSol（数字，SOL；0 表示禁用支出）、requireConfirm（bool）。
• list_proposals — agentId、status（pending | executed | dismissed | undone | failed）、limit（1–200）。
• dryrun_proposal / dismiss_proposal / undo_action — agentId、proposalId。
• adjust_proposal — agentId、proposalId、params（该提案类型的完整替换参数）。
• execute_proposal — agentId、proposalId、confirm（bool——不可逆的 SOL 转账必须提供）。
• list_autopilot_activity — agentId（可选）、limit（1–200）、cursor（取自先前的 next_cursor）。

循环

// 1. Grant the agent a reversible capability
// set_autopilot_config
> { "agentId": "…", "enabled": true, "scopes": { "create_alert": true } }
{ "ok": true, "config": { "enabled": true, "scopes": { "create_alert": true, "briefing": false, "wallet_transfer": false }, "daily_spend_sol": 0, "require_confirm": true } }

// 2. Let the agent propose actions from its memory
// generate_proposals
> { "agentId": "…" }
{ "ok": true, "createdCount": 1, "source": "memory",
  "created": [ { "id": "p_…", "kind": "create_alert", "title": "Alert when $THREE crosses $0.01",
                 "rationale": "You noted interest in $THREE around $0.01 — I'll watch it.", "status": "pending" } ] }

// 3. Preview before acting
// dryrun_proposal
> { "agentId": "…", "proposalId": "p_…" }
{ "ok": true, "preview": { "kind": "create_alert", "willDo": "Create a real alert rule… Reversible.",
                           "checks": [ { "label": "Scope \"create_alert\" granted", "ok": true } ], "blocked": false } }

// 4. Execute for real (reversible kind — no confirm needed)
// execute_proposal
> { "agentId": "…", "proposalId": "p_…" }
{ "ok": true, "receipt": "Created a price above alert.", "actionId": "1843", "proposal": { "status": "executed" } }

// 5. Changed your mind? Undo it.
// undo_action
> { "agentId": "…", "proposalId": "p_…" }
{ "ok": true, "proposal": { "status": "undone" } }

要支出真实 SOL，所有者必须已授予 scopes.wallet_transfer、设置大于 0 的 dailySpendSol，并且（除非已预先授权）必须使用 confirm:true 重新调用 execute_proposal。以上三项均由服务端检查。Agent 只会支出 SOL——绝不会出售或发送 $THREE。

要求

• Node.js >= 20。
• Agent 所有者的 three.ws 凭证（THREE_WS_API_KEY）。
• 网络可访问 https://three.ws（或你自己的 THREE_WS_BASE）。

环境变量

变量	必需	默认值	说明
THREE_WS_API_KEY	是	—	three.ws API 密钥（sk_live_…）或 OAuth 访问令牌。属于机密信息，可能会转移实际的 SOL。
THREE_WS_BASE	否	https://three.ws	仅在自行托管或指向预览环境时覆盖。
THREE_WS_TIMEOUT_MS	否	60000	每个请求的超时时间（生成过程会在服务端运行一次大模型）。

链接

• 主页：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}