Hyperd Mcp

Name: Hyperd Mcp
Author: hyperd-ai

本地服务

github.com/hyperd-ai金融数据120 周前更新

代码仓库

关于 Hyperd Mcp

Hyperd Mcp 将 hyperD 的 DeFi 数据与风险分析接口提供给 Base 上的 AI Agent 和 MCP 客户端，适用于交易前评估。它涵盖钱包、代币、协议、清算、收益与治理等查询，并支持按调用以 USDC 付费。

主要功能

01提供钱包、代币与协议数据查询
02评估代币安全与钱包风险
03聚合 DEX 报价并估算 Gas
04分析清算风险与钱包盈亏
05提供治理摘要及合成风险判断
06支持多请求捆绑和清算监控

适用场景

01交易前检查代币或合约风险
02评估跨协议头寸的清算风险
03比较 DEX 路由并估算交易 Gas
04汇总钱包表现或治理提案

MCP 相关

该 MCP 服务向客户端公开 hyperD 的 DeFi 数据、风险分析、合成判断及监控工具，可通过本地 stdio 服务或远程 HTTPS MCP 连接。付费调用通过 Base 上的 USDC 支付。

#defi #crypto #base #x402 #usdc #wallet #liquidation #token-security #pnl #dex-quote #evm #coinbase

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "hyperd": {
      "command": "npx",
      "args": [
        "-y",
        "hyperd-mcp"
      ],
      "env": {
        "HYPERD_WALLET_PRIVATE_KEY": "<HYPERD_WALLET_PRIVATE_KEY>"
      }
    }
  }
}

启动命令npx -y hyperd-mcp

需要配置的环境变量

HYPERD_WALLET_PRIVATE_KEY密钥0x-prefixed 32-byte EVM private key for the wallet that pays for hyperD calls in USDC on Base. The wallet must hold USDC (~$5 is plenty for hundreds of decision cycles). The MCP server signs EIP-3009 transfer authorizations per call.

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

安装包

npmhyperd-mcp1.1.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

hyperD MCP 服务

提供 24 个收费的 hyperD x402 工具——17 个数据／风险端点、6 个高级综合评估结果（$0.30–$1.50）和一个多调用捆绑工具——以及 3 个免费元工具（启用后还有 3 个监控工具），数据来自 api.hyperd.ai。可接入 Claude Desktop、Cursor、Cline、Zed 或任何兼容 MCP 的客户端。

功能

每次工具调用都会：

向相应的 api.hyperd.ai 端点发送请求
收到包含付款要求的 HTTP 402 响应
使用你的钱包签署 EIP-3009 USDC 转账授权
携带付款标头重试
将数据返回给 AI 助手

每次调用需在 Base 上支付 $0.005–$1.50 的 USDC——数据／风险端点为 $0.005–$0.10，高级综合评估结果为 $0.30–$1.50。无需订阅，无需账户。

免费试用

每个 IP 每 24 小时的前 5 次调用免费——无需钱包、注册或 API 密钥。直接使用 curl：

curl "https://api.hyperd.ai/api/balance?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

终身上限：每个 IP 10 次调用。达到上限（或每日配额耗尽）后，端点会返回 HTTP 402——通过 Python SDK 或 TypeScript MCP 服务在 Base 上签署一笔小额 EIP-3009 USDC 付款。高级综合评估层级（$0.30 起）始终需要付款，不符合免费层级的条件。

/api/wallet/pnl 的免费层级上限更严格：每个 IP 每天 1 次调用（上游负载较重）。

所需条件

一个在 Base 上至少有 $0.30 USDC 的钱包（尝试每个工具一次的初始费用约为 $0.62）
钱包的私钥或 12 词 BIP-39 助记词
已安装 Node 20+

安装和配置

步骤 1 — 生成或使用现有钱包

测试时，请使用新钱包，不要使用主钱包。 一种简单方法：

node -e "const {generatePrivateKey, privateKeyToAccount} = require('viem/accounts'); const pk = generatePrivateKey(); console.log('Address:', privateKeyToAccount(pk).address); console.log('Private key:', pk);"

向打印出的地址发送约 $1 的 Base 上的 USDC。

步骤 2 — Claude Desktop

编辑 Claude Desktop 配置文件（位置：macOS ~/Library/Application Support/Claude/claude_desktop_config.json，Windows %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "hyperd": {
      "command": "npx",
      "args": ["-y", "hyperd-mcp"],
      "env": {
        "HYPERD_WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

重启 Claude Desktop。hyperD 工具会显示在对话的工具列表中。

步骤 3 — 试用

在任意对话中向 Claude 提问：

“Base 上 USDC 的安全评分是多少？请使用 hyperd.token.security 工具。”

Claude 会调用我们的端点，从你的钱包支付 $0.05 并返回结果。整个流程约需 2 秒。

Cursor / Cline / Zed

每个兼容 MCP 的客户端都有类似的配置文件。配置方式相同：将服务命名为 hyperd，命令设为 npx -y hyperd-mcp，并设置 HYPERD_WALLET_PRIVATE_KEY 环境变量。

完整的 MCP 客户端列表和各客户端配置文档，请参阅 https://modelcontextprotocol.io/clients。

本地开发安装（不发布到 npm）

如果你想从源代码运行，而不是使用 npx：

git clone https://github.com/hyperd-ai/hyperd-mcp.git
cd hyperd-mcp
npm install
npm run build

然后在 Claude Desktop 配置中指向本地构建：

{
  "mcpServers": {
    "hyperd": {
      "command": "node",
      "args": ["/full/path/to/hyperd-mcp/dist/server.js"],
      "env": {
        "HYPERD_WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

可用工具

工具	价格	功能
`hyperd.balance.get`	$0.01	多链 ERC-20 + 原生代币余额查询
`hyperd.yield.recommend`	$0.05	主观 DeFi 收益推荐
`hyperd.token.info`	$0.01	聚合代币元数据（CoinGecko + DefiLlama）
`hyperd.token.security`	$0.05	基于 GoPlus 的安全风险评分
`hyperd.wallet.risk`	$0.10	Chainalysis 制裁筛查 + GoPlus 启发式检测
`hyperd.protocol.tvl`	$0.01	DefiLlama 协议健康状况
`hyperd.gas.estimate`	$0.005	提供小费百分位数的 Gas 预言机
`hyperd.dex.quote`	$0.02	多聚合器最佳 DEX 路径
`hyperd.wallet.persona`	$0.10	钱包行为分类
`hyperd.contract.audit`	$0.10	交易前合约安全综合评估
`hyperd.governance.summarize`	$0.10	由大模型总结 DAO 提案
`hyperd.sentiment.token`	$0.05	来自 Farcaster 的代币情绪
`hyperd.liquidation.risk`	$0.10	跨协议清算风险（Aave V3 / Compound v3 / Spark / Morpho）
`hyperd.wallet.anomaly`	$0.10	对照 180 天基线检测钱包异常
`hyperd.wallet.pnl`	$0.05	已实现 + 未实现盈亏（FIFO/LIFO/HCFO）
`hyperd.budget.guardian`	$0.01	Agent USDC 支出可见性 + 额度检查
`hyperd.bundle`	$0.20 固定	多次调用：在一次结算中执行 1-10 次付费 GET 请求
`hyperd.watch.create`	$3.00 预付	订阅持续清算监控（HMAC Webhook）
`hyperd.watch.list`	（所有者免费）	列出你的活跃监控
`hyperd.watch.cancel`	（所有者免费）	取消一项监控

综合评估层级 — 组合判定（Haiku 4.5，v1.1.0）

每个综合评估工具都会在内部调用多个子项，并返回包含单一 verdict + inputs + methodology.version + coverage 的结果，由 Claude Haiku 4.5 撰写。

工具	价格	功能
`hyperd.risk.full_audit`	$0.35	组合钱包风险评估：余额 + 制裁筛查 + 行为分类 + 合约 + 混币器。风险等级：安全 / 中等 / 偏高 / 严重。
`hyperd.token.archetype`	$0.30	代币分类：稳定币 / 蓝筹 / 中盘 / Meme 币 / 封装代币 / 治理代币 / 未验证。
`hyperd.wallet.thesis`	$0.50	通俗易懂的钱包行为分析：交易者 / 长期持有者 / 收益农场参与者 / MEV 机器人 / 已遭入侵 / 不活跃。
`hyperd.wallet.threat_brief`	$1.50	2-3 句安全判定：干净 / 关注 / 偏高 / 严重。
`hyperd.gov.translate`	$1.00	用通俗语言解读 Snapshot/Tally 提案（缓存 1 年）。
`hyperd.yield.allocation`	$1.00	按风险等级划分指定金额的投资组合（缓存 6 小时）。

完整 HTTP API 文档：https://api.hyperd.ai/api/discover

安全

使用热钱包，不要使用你的主钱包。MCP 服务运行时会将私钥保存在进程内存中。
限制支出，只转入你打算使用的金额。没有内置支出限额；钱包余额就是限额。
不要提交私钥。 Claude Desktop 配置文件是本地文件；不要分享。

使用助记词而非私钥进行配置

如果你有 12 或 24 个单词的 BIP-39 助记词，而非原始密钥：

"env": {
  "HYPERD_WALLET_MNEMONIC": "word1 word2 ... word12"
}

按标准 Ethereum 路径 m/44'/60'/0'/0/0 派生。

可选环境变量

HYPERD_API_BASE — 默认值为 https://api.hyperd.ai。可覆盖为测试网或可自托管服务。
HYPERD_BASE_RPC — 默认使用公共 Base RPC。可覆盖以获取更高的速率限制。

远程 MCP-over-HTTPS（无需安装）

如果你不想在本地运行 stdio 服务，hyperD 的完整工具目录也可通过远程 MCP 服务使用：

POST https://api.hyperd.ai/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

相同的 24 个付费工具、相同的免费额度（每天每个 IP 5 次调用，终身 10 次），以及额度用尽后付费调用所用的相同 X-Payment 身份验证模式。无需 npm install，也无需为每个 IDE 单独配置——只需一个 URL。

适用于以下场景：

你要将 Agent 部署到无服务器平台（Vercel、Lambda），并且不想打包 stdio 进程
你在使用需要远程 URL 的 MCP 感知型服务（Smithery enterprise、托管网关）
你想先通过命令行使用 curl 测试 API 接口，再决定是否本地安装

服务卡片：https://api.hyperd.ai/.well-known/mcp.json。

许可证

MIT——与父级代码库相同。

支持 Markdown

登录后评论

基本信息

作者: hyperd-ai
语言: node
版本: 1.1.1
传输方式: stdio
收录时间: 2026年5月12日
最近更新: 20 周前
官方 Registry: io.github.hyperd-ai/hyperd-mcp

报告问题

第一次接触 MCP？

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

阅读入门指南

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