mcpField
W
walletlens

walletlens

本地服务
github.com/shawnwollenberg金融数据013 周前更新
代码仓库

关于 walletlens

WalletLens MCP 为兼容 MCP 的 Agent 提供 EVM 钱包报告和 Robinhood Stock Token 情报。它将免费服务查询工具与付费资产组合及交易报告结合，使用专用钱包在本地签署 x402 付款。

主要功能

  1. 01获取资产组合余额和美元估值
  2. 02查看标准化交易历史
  3. 03生成资产组合与交易汇总报告
  4. 04查询服务、链及 OpenAPI 元数据
  5. 05按规则在本地签署 x402 付款

适用场景

  1. 01查看 EVM 钱包资产组合
  2. 02检查钱包交易历史
  3. 03请求综合钱包报告
  4. 04查询服务价格和支持的链

MCP 相关

作为本地 MCP 服务通过 stdio 通信，并提供免费元数据工具及付费钱包分析工具。付费请求使用本地签署的 x402 付款；私钥不会发送给 WalletLens。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "shawnwollenberg-walletlens": {
      "command": "npx",
      "args": [
        "-y",
        "@shawnwollenberg/walletlens-mcp"
      ],
      "env": {
        "WALLETLENS_X402_PRIVATE_KEY": "<WALLETLENS_X402_PRIVATE_KEY>",
        "WALLETLENS_MAX_PAYMENT_USDC": "<WALLETLENS_MAX_PAYMENT_USDC>",
        "WALLETLENS_EXPECTED_PAY_TO": "<WALLETLENS_EXPECTED_PAY_TO>",
        "WALLETLENS_BASE_URL": "<WALLETLENS_BASE_URL>"
      }
    }
  }
}
启动命令npx -y @shawnwollenberg/walletlens-mcp
需要配置的环境变量
WALLETLENS_X402_PRIVATE_KEY密钥Dedicated agent-wallet private key for paid x402 tools.
WALLETLENS_MAX_PAYMENT_USDCMaximum USDC allowed for one report. Defaults to 0.02.
WALLETLENS_EXPECTED_PAY_TOExpected WalletLens payment recipient address.
WALLETLENS_BASE_URLWalletLens API origin. Defaults to the production service.

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

安装包
npm@shawnwollenberg/walletlens-mcp0.1.2

工具

6

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

此工具无需参数。

详细介绍

WalletLens MCP

WalletLens MCP 通过 x402，让兼容 MCP 的 Agent 使用免费的服务发现功能和付费的 EVM 钱包情报，包括 Robinhood Stock Token 报告。

服务通过 stdio 在本地运行。付费请求由专用 Agent 钱包在本地签名；WalletLens 永远不会收到私钥。

可用工具

  • get_service_metadata — 免费获取实时定价、文档和服务元数据
  • get_supported_chains — 免费获取支持的链的元数据
  • get_openapi_schema — 免费获取 OpenAPI 架构
  • get_portfolio — 付费获取投资组合余额和美元价值
  • get_tx_history — 付费获取规范化的交易历史
  • get_wallet_report — 付费获取投资组合和交易的综合报告

在 Base 主网上，每次调用付费工具最多收费 0.02 USDC。每次调用最多尝试支付一次。

要求

  • Node.js 20 或更高版本
  • 已充值 Base USDC 的专用 EVM Agent 钱包
  • 兼容 MCP 的客户端

MCP 配置

将以下内容添加到 MCP 客户端配置中。将私钥替换为余额较低的专用 Agent 钱包，并确保配置不纳入源代码管理。

{
  "mcpServers": {
    "walletlens": {
      "command": "npx",
      "args": ["--yes", "@shawnwollenberg/[email protected]"],
      "env": {
        "WALLETLENS_X402_PRIVATE_KEY": "0xYOUR_DEDICATED_AGENT_PRIVATE_KEY",
        "WALLETLENS_MAX_PAYMENT_USDC": "0.02",
        "WALLETLENS_EXPECTED_PAY_TO": "0xA7c82E9775A9594c673E3Fde8a42D3D17dE2B957"
      }
    }
  }
}

无需私钥即可使用免费工具。配置 WALLETLENS_X402_PRIVATE_KEY 前，付费工具会返回 missing_private_key 结果。

支付安全策略

签名前，MCP 服务要求满足以下所有条件：

  • exact 支付方案
  • Base 主网（eip155:8453）
  • Base USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
  • 金额不超过 WALLETLENS_MAX_PAYMENT_USDC，默认值为 0.02 USDC
  • WalletLens 来源以及请求的 WalletLens 资源路径
  • 配置的收款方，默认为 0xA7c82E9775A9594c673E3Fde8a42D3D17dE2B957

如果支付挑战违反此策略，服务将拒绝签名。

环境变量

变量必需默认值用途
WALLETLENS_X402_PRIVATE_KEY仅付费工具需要—专用本地签名密钥
WALLETLENS_MAX_PAYMENT_USDC否0.02每次工具调用的最高付款金额
WALLETLENS_EXPECTED_PAY_TO否WalletLens 收款方必需的付款收款方
WALLETLENS_BASE_URL否https://walletlens.wallyweb.comWalletLens API 来源
WALLETLENS_REQUEST_TIMEOUT_MS否20000请求超时时间，单位为毫秒

直接运行

npx --yes @shawnwollenberg/[email protected]

该进程通过 MCP stdio 通信，通常不会打印人类可读的输出。使用 --help 或 --version 查看 CLI 信息。

链接

评论

支持 Markdown

第一次接触 MCP？

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

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