Tychi Mcp

Tychi MCP (@tychilabs/tyi-mcp)

AI エージェントにウォレットを持たせましょう。オンボーディング、資金の保有、送金、ポリシーに基づく支払いができます。

Cursor などのホスト向けのエージェントネイティブな MCP サーバー（stdio）です。9 つのツールを備えています。ルーティング（tyi_route）、準備状況の確認（tyi_status）、オンボーディング、高速なウォレットのライフサイクル管理（create／import／switch）、および Arbitrum One で残高確認、送金、ポリシーに基づく支払いを行う tyi_chat です。秘密鍵はオペレーターのマシン上の ~/.tyi に暗号化して保存され、署名がデバイスの外に出ることはありません。ホスト型の Tychi brain がインテントを解析して LLM を実行します。TYCHI_BRAIN_URL を設定してください（HTTPS を推奨します。SECURITY.md を参照）。

エージェント向け → @tychilabs/[email protected] · 人間向け → @tychilabs/tyi

---

機能

• エージェントのルーティング — tyi_route がインテントを適切なツールに振り分けます（tyi_chat の誤用による遅延を回避します）
• 準備状況のゲート — tyi_status がウォレット操作の前にモードを確認します
• オンボーディング — 初回セットアップ（パスワード、LLM プロバイダー、API キー）用の tyi_onboard と tyi_onboard_schema
• ウォレットのライフサイクル管理 — tyi_create_wallet、tyi_import_wallet、tyi_switch_wallet（高速で、brain のループは不要）
• エージェントチャット — 残高確認、送金、振替、支払い、ポリシー、上限、履歴用の tyi_chat
• 複数ウォレット — 1 つのキーストアから、アクティブなウォレットの作成、インポート、切り替えが可能
• ポリシー上限 — 署名の前に支出上限を適用
• ローカル署名 — 秘密鍵はオペレーターのマシン上のメモリーにのみ保持
• ガスレスルーティング — クロスチェーンのガス決済に対応する UGF 決済レール
• 監査ログ — ~/.tyi にローカルのアクティビティ履歴を記録
• リセット — オペレーターの確認後、tyi_reset がローカルデータを消去

ベータ版は Arbitrum One（チェーン ID 42161）で提供されます。EVM の残高確認、送金、UGF ガスレス決済に対応しています。レジストリーにはさらに多くのチェーンがあり、Solana／Sui のインポートもサポートされています。

---

Arbitrum One

Arbitrum One 上のオンチェーンエージェントウォレットです。セルフカストディ、ローカル署名、現在利用可能な UGF ガスルーティングに対応しています。

ロードマップ	実現できること
自動化	ポリシーに基づくエージェント — 定期送金、トリガー、スケジュールされたフロー
取引	Arbitrum の流動性を利用したスポットスワップ — エージェントが見積もり、オペレーターが確認
貸し出し	Arbitrum のマネーマーケットへの供給 — キーストアから出ることなく利回りを獲得
借り入れ	担保付き借り入れ — 上限を適用し、完全なセルフカストディを実現

---

エージェントのフロー（必須）

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	初回セットアップ、または LLM のみのセットアップ
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 を参照してください — 信頼モデル、brain の通信方式（HTTP ベータエンドポイント）、機密性の高いツール、サプライチェーンの固定。インストールスクリプトはありません。

---

MCP ホストの設定

リポジトリには Cursor Directory 用の Open Plugins の .mcp.json が含まれています。ホスト環境で TYI_PASSWORD と TYCHI_BRAIN_URL を設定してください（HTTPS の brain を推奨）。

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

コード内で未設定時に使用されるベータ版のデフォルト値：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	ウォレットはあるが LLM キーがない — LLM フィールドのみをオンボード
ready	tyi_chat を使用可能

オペレーターが提供する情報（決して推測しないでください）： キーストアのパスワード、LLM プロバイダーと API キー、任意のインポート用ニーモニック。

オンボード後は、チャットより MCP の env で TYI_PASSWORD を設定することを推奨します。

フィールド	プロンプト
password	~/.tyi のキーストアのパスワード → 後で MCP の env に TYI_PASSWORD を設定
agent_name	エージェント名（デフォルトは Tychi）
llm_provider	anthropic | gemini | openai | groq
llm_api_key	プロバイダーの API キー（検証後、brain に暗号化して保存）
mnemonic	任意のインポート用（fresh のみ）

---

連携とデータの削除

1. { "confirm": true } を指定して tyi_reset を実行 — ~/.tyi を消去
2. MCP の env から TYI_PASSWORD を削除
3. OpenClaw：openclaw mcp unset tychi を実行し、その後 openclaw mcp reload を実行

---

エラー

症状	対処方法
チャットで not_ready が表示される	オンボーディングのフローを実行
TYI_PASSWORD env required	オンボード後に env を設定し、ホストを再読み込み
no_llm_key / llm_key がない	tyi_onboard で llm_only を指定
partial install	tyi_reset を実行してから、新規にオンボード
brain で fetch failed が表示される	TYCHI_BRAIN_URL を明示的に設定し、HTTPS のセルフホスト環境、またはベータ版の http://hosted_brain.tychilabs.com を使用

---

環境変数

変数	必須	デフォルト
TYI_PASSWORD	オンボード後	—
TYCHI_BRAIN_URL	推奨	http://hosted_brain.tychilabs.com（ベータ版。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
• 人間向け CLI：https://www.npmjs.com/package/@tychilabs/tyi

---

ライセンス

Apache License 2.0 — LICENSE を参照してください。ランタイム依存関係：@tychilabs/tyi。