Tychi Mcp

Tychi MCP（@tychilabs/tyi-mcp）

为你的 AI Agent 配备钱包——接入、持有资金、发送并按策略付款。

面向 Agent 的 MCP 服务（stdio），适用于 Cursor 和其他宿主。提供 9 个工具：路由（tyi_route）、就绪状态（tyi_status）、接入、快速钱包生命周期（create / import / switch），以及用于查询余额、发送资金和执行策略管控付款的 tyi_chat，支持 Arbitrum One。私钥加密后存储在操作员设备上的 ~/.tyi 中；签名操作绝不会离开设备。托管的 Tychi brain 会解析意图并运行 LLM——请配置 TYCHI_BRAIN_URL（建议使用 HTTPS；参见 SECURITY.md）。

面向 Agent → @tychilabs/[email protected] · 面向人类用户 → @tychilabs/tyi

---

功能

• Agent 路由 — tyi_route 将意图映射到正确的工具（避免错误调用 tyi_chat 导致速度变慢）
• 就绪检查 — tyi_status 在执行任何钱包操作前检查模式
• 接入 — 首次设置使用 tyi_onboard + tyi_onboard_schema（密码、LLM 提供商、API 密钥）
• 钱包生命周期 — tyi_create_wallet、tyi_import_wallet、tyi_switch_wallet（快速执行，无需 brain 循环）
• Agent 对话 — 使用 tyi_chat 查询余额、发送和转账、付款、策略、限额及历史记录
• 多钱包 — 从同一个密钥库创建、导入钱包并切换活动钱包
• 策略限额 — 签名前强制执行支出限额
• 本地签名 — 私钥仅保存在操作员设备的内存中
• 免 Gas 路由 — 使用 UGF 付款通道结算跨链 Gas 费用
• 审计日志 — 在 ~/.tyi 中记录本地活动
• 重置 — 操作员确认后，tyi_reset 会清除本地数据

Beta 版仅支持 Arbitrum One（链 ID 为 42161）——支持 EVM 余额查询、资金发送和 UGF 免 Gas 付款。注册表中还有更多链；支持导入 Solana/Sui 钱包。

---

Arbitrum One

Arbitrum One 上的链上 Agent 钱包——现已支持自主托管、本地签名和 UGF Gas 路由：

路线图	可实现的功能
自动化	受策略管控的 Agent——定期发送、触发器和定时流程
交易	在 Arbitrum 流动性池中进行现货兑换——Agent 报价，操作员确认
借贷	在 Arbitrum 货币市场提供资产——收益留在密钥库中
借款	抵押借款——强制执行限额，完全自主托管

---

Agent 流程（必需）

tyi_route → tyi_status
  → direct tool (onboard / create / import / switch / reset)   ← FAST
  → tyi_chat (balance / send / pay / policy only)              ← SLOW

当 tyi_status.ready 为 false 时，绝不要调用 tyi_chat。

导入助记词或私钥时，只能调用 tyi_import_wallet（绝不能通过 tyi_chat）。

---

工具

工具	适用场景
tyi_route	首先 — 意图 → 工具映射
tyi_status	会话开始时 — 是否就绪？还缺少什么？
tyi_onboard_schema	开始设置前查看字段架构
tyi_onboard	首次设置或仅设置大模型
tyi_create_wallet	按名称创建新钱包
tyi_import_wallet	导入助记词或私钥（EVM / Solana / Sui）
tyi_switch_wallet	更改当前钱包
tyi_reset	清除 ~/.tyi（confirm: true）
tyi_chat	余额、发送、付款、转账、策略、限额

---

安装

固定版本（生产环境不要使用浮动的 @beta）：

npx @tychilabs/[email protected]
npx @tychilabs/[email protected] --tools

---

安全

参见 SECURITY.md — 信任模型、大脑传输（HTTP beta 端点）、敏感工具、供应链版本固定。不使用安装脚本。

---

MCP 主机配置

仓库包含供 Cursor Directory 使用的 .mcp.json（Open Plugins）。在主机环境中设置 TYI_PASSWORD 和 TYCHI_BRAIN_URL（建议使用 HTTPS 大脑）。

{
  "mcpServers": {
    "tychi": {
      "command": "npx",
      "args": ["@tychilabs/[email protected]"],
      "env": {
        "TYI_PASSWORD": "<from tyi_onboard>",
        "TYCHI_BRAIN_URL": "<https brain URL — required>"
      }
    }
  }
}

如果未设置，代码中的 beta 默认值为：http://hosted_brain.tychilabs.com — 仅在 HTTPS 自托管或可信网络中使用。

OpenClaw：

openclaw mcp set tychi '{"command":"npx","args":["@tychilabs/[email protected]"],"env":{"TYI_PASSWORD":"<password>","TYCHI_BRAIN_URL":"<https brain URL>"}}'
openclaw mcp reload

---

引导模式

模式	含义
fresh	没有钱包 — 运行 tyi_onboard
llm_only	钱包已存在，但没有大模型密钥 — 仅引导设置大模型字段
ready	可使用 tyi_chat

**操作员提供（切勿编造）：**密钥库密码、大模型提供商 + API 密钥、可选的导入助记词。

引导完成后，优先通过 MCP env 设置 TYI_PASSWORD，而不是在聊天中提供。

字段	提示
password	~/.tyi 的密钥库密码 → 后续在 MCP 环境中设置为 TYI_PASSWORD
agent_name	Agent 名称（默认值：Tychi）
llm_provider	anthropic | gemini | openai | groq
llm_api_key	提供商 API 密钥（经过验证，并在大脑上加密存储）
mnemonic	可选导入（仅限 fresh 模式）

---

移除集成和数据

1. 使用 { "confirm": true } 调用 tyi_reset — 清除 ~/.tyi
2. 从 MCP 环境中移除 TYI_PASSWORD
3. OpenClaw：运行 openclaw mcp unset tychi，然后运行 openclaw mcp reload

---

错误

症状	操作
聊天时出现 not_ready	运行引导流程
出现 TYI_PASSWORD env required	引导完成后设置环境变量；重新加载主机
出现 no_llm_key / 缺少 llm_key	使用 tyi_onboard 的 llm_only 模式
出现 partial install	运行 tyi_reset，然后重新进行全新引导
大脑出现 fetch failed	显式设置 TYCHI_BRAIN_URL；使用 HTTPS 自托管，或使用 beta 地址 http://hosted_brain.tychilabs.com

---

环境变量

变量	是否必需	默认值
TYI_PASSWORD	引导完成后必需	—
TYCHI_BRAIN_URL	建议设置	http://hosted_brain.tychilabs.com（beta；建议使用 HTTPS 覆盖默认值）
TYI_DATA_DIR	否	~/.tyi
KEYSTORE_PASSWORD	别名	与 TYI_PASSWORD 相同

---

链接

• 网站：https://tychilabs.com
• npm：https://www.npmjs.com/package/@tychilabs/tyi-mcp
• GitHub：https://github.com/TychiWallet/tyi-mcp
• 人工操作命令行：https://www.npmjs.com/package/@tychilabs/tyi

---

许可证

Apache License 2.0 — 参见 LICENSE。运行时依赖：@tychilabs/tyi。