mcpField
C
Cloaked Agent

Cloaked Agent

本地服务
cloakedagent.com金融数据134 周前更新
代码仓库访问官网

关于 Cloaked Agent

Cloaked Agent 是用于 Solana 的 SDK 和 MCP 服务，可为 AI Agent 提供受限支出账户，无需共享钱包密钥。其工具可查询余额和限额、发送 SOL 或 USDC，并自动支付 x402 费用。

主要功能

  1. 01链上执行单笔及总额限额
  2. 02查询余额与支出状态
  3. 03支持 SOL 和 USDC 付款
  4. 04自动支付 x402 费用
  5. 05可选 ZK 隐私证明

适用场景

  1. 01查询 Agent 账户可用余额
  2. 02发送设有上限的 SOL 或 USDC 付款
  3. 03付费获取受 x402 保护的资源

MCP 相关

MCP 服务提供查询余额和支出限制、发送 SOL 或 USDC，以及自动付款获取受 x402 保护资源的工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloakedagent-cloaked": {
      "command": "npx",
      "args": [
        "-y",
        "@cloakedagent/sdk"
      ],
      "env": {
        "CLOAKED_AGENT_KEY": "<CLOAKED_AGENT_KEY>",
        "CLOAKED_BACKEND_URL": "<CLOAKED_BACKEND_URL>",
        "SOLANA_RPC_URL": "<SOLANA_RPC_URL>"
      }
    }
  }
}
启动命令npx -y @cloakedagent/sdk
需要配置的环境变量
CLOAKED_AGENT_KEY密钥Base58 encoded Cloaked Agent private key
CLOAKED_BACKEND_URLBackend relay URL (default: https://api.cloakedagent.com)
SOLANA_RPC_URL密钥Solana RPC endpoint URL (default: https://api.devnet.solana.com)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@cloakedagent/sdk0.2.0

工具

4

收录的工具列表 · 更新于 2 周前

参数类型必填说明
agent_keystring否Cloaked Agent 密钥（可选；未提供时使用环境变量 CLOAKED_AGENT_KEY）

详细介绍

@cloakedagent/sdk

为 Solana 上的 AI Agent 提供无需信任的消费账户

赋予 AI Agent 消费能力，无需交出你的钱包密钥。链上强制执行的限额，AI Agent 绝对无法绕过。

文档 · 网站 · GitHub

安装

npm install @cloakedagent/sdk

快速开始

面向 AI Agent（MCP）

添加到 Claude Desktop 或兼容 MCP 的客户端：

{
  "mcpServers": {
    "cloaked": {
      "command": "npx",
      "args": ["@cloakedagent/sdk/mcp"],
      "env": {
        "CLOAKED_AGENT_KEY": "your-agent-key-here"
      }
    }
  }
}
面向开发者
import { CloakedAgent } from "@cloakedagent/sdk";

// Load agent from key
const agent = new CloakedAgent(agentKey, rpcUrl);

// Check balance
const balance = await agent.getBalance();

// Spend within limits
await agent.spend({
  destination: recipientPubkey,
  amount: 100_000_000 // 0.1 SOL in lamports
});

// Spend USDC
await agent.spendToken({
  destination: recipientPubkey,
  mint: USDC_MINT,
  amount: 5_000_000 // 5 USDC
});

功能

  • 链上约束 - Solana 程序强制执行单笔交易、每日和总额限额
  • MCP 集成 - 通过 Model Context Protocol 与 Claude 和其他 AI Agent 配合使用
  • x402 支持 - 自动为按次付费的 API 付款
  • USDC 支持 - 发送 USDC，并可按代币设置消费约束
  • 隐私模式 - 可选用 ZK 证明隐藏钱包与 Agent 的关联

API

CloakedAgent
// Create from agent key
const agent = new CloakedAgent(agentKey: string, rpcUrl: string);

// Properties
agent.publicKey      // Agent's public key
agent.vaultPda       // Vault address (holds funds)
agent.agentStatePda  // State account address

// Methods
await agent.getBalance()           // Get vault balance in lamports
await agent.getStatus()            // Get full status with constraints
await agent.spend({ destination, amount })  // Spend SOL
await agent.spendToken({ destination, mint, amount }) // Spend USDC
await agent.getTokenBalance(mint)   // Get token balance
await agent.enableToken(owner, mint, constraints) // Enable USDC
MCP 工具

作为 MCP 服务运行时，提供以下工具：

  • cloak_balance - 查看可用余额
  • cloak_status - 获取消费限额和约束
  • cloak_pay - 向目标地址发送 SOL 或 USDC
  • cloak_x402_fetch - 获取受 x402 保护的资源并自动付款

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。