使用说明
MTRKR MCP服务器
将AI代理连接到的只读MCP服务器 MTRKR 钱包智能开启 MegaETH,以太坊L2。
服务器注册 14 mtrkr_* 工具用于:
.mega名称解析- ERC-20投资组合和美元定价
- NFT持股
- DeFi流动性头寸(AMM+集中流动性整合)
- 钱包活动摘要
- 审批和操作员扫描
- 地址检查
- ERC-20代币风险扫描
- 交易解码
- ETH/USD定价
- 钱包交易分析
钱包交易分析是围绕 MegaETH终端活动 (季节结构和激励措施遵循MTRKR发布的航站楼规则)。他们使用 终端波浪周期 从MTRKR活动配置加载,例如第1波 2026-04-28–2026-05-05, 取决于活动的MTRKR活动配置;配置更新时,wave id和日期范围可能会发生变化。这些工具支持主动波形快照、最近完成的波形审查、多钱包比较以及可选的呼叫者提供的粗略对齐检查点。
这些分析意味着 陪伴你重温每一次浪潮:他们总结了最近的链上互动、应用覆盖率的提高、出站活动和类似的启发式方法。他们是 非官方竞选或得分.
服务器不请求私钥、签署交易或提交链上交易。
钱包范围的工具接受MegaETH 0x 地址或a .mega 名称(例如。 mirage.mega).令牌风险扫描预计 ERC-20代币合约 地址。事务解码需要 32字节事务哈希 (0x 加 64 十六进制字符)。ETH价格工具需要 无输入;对于“N ETH的美元价值”等问题,请致电 mtrkr_eth_price 然后乘以 N 客户端(或让代理来做)。看 支持的输入.
需求
- Node.js 20+ (参见
engines在package.json) - 一 MCP兼容主机 (例如光标、克劳德桌面)
- 网络接入 到API使用的MTRKR和上游数据源
- 没有API密钥 对于默认的公共MTRKR来源;如果你覆盖
MTRKR_API_URL,身份验证要求取决于该主机
支持的输入
| 输入类型 | 工具 |
|---|---|
.mega 姓名或钱包 0x |
钱包投资组合、NFT、活动摘要/快速统计、LP头寸、安全扫描、分析GET/分析、比较 |
.mega 名称或任何MegaETH 0x 地址 |
mtrkr_resolve_name, mtrkr_inspect_address |
代币合约 0x (不是钱包) |
mtrkr_token_scan |
交易哈希, 0x 紧随其后 64 十六进制字符 |
mtrkr_decode_transaction |
| 没有 | mtrkr_eth_price |
在调用支持API(如适用)之前,通过MTRKR解析名称。
快速启动
将服务器添加到MCP配置中, 重新启动客户端,工具应该出现。如果您使用 npx.
稳定(推荐)
使用 稳定的 标签npm公开为 latest:
光标 — .cursor/mcp.json (项目或全球):
{
"mcpServers": {
"mtrkr": {
"command": "npx",
"args": ["mtrkr-mcp-server@latest"]
}
}
}
克劳德桌面版 — claude_desktop_config.json (路径因操作系统而异;请参阅Anthropic文档):
{
"mcpServers": {
"mtrkr": {
"command": "npx",
"args": ["mtrkr-mcp-server@latest"]
}
}
}
验证安装
重新启动MCP主机后,请尝试:
- “解决海市蜃楼。mega”
- “MegaETH的当前ETH价格是多少?”
Beta版/预发布版
测试版产品线的用户MCP配置:
{
"mcpServers": {
"mtrkr": {
"command": "npx",
"args": ["mtrkr-mcp-server@beta"]
}
}
}
您还可以固定一个精确的预发布(示例): mtrkr-mcp-server@1.2.0-beta.0。参见 版本 在npm上。
配置
MCP的可选环境变量 过程 (在MCP配置中设置 env 如果你的客户支持,请阻止):
| 变量 | 必填 | 描述 |
|---|---|---|
MTRKR_API_URL |
没有 | 起源 对于MTRKR HTTP API(方案+主机, 没有尾随斜线).请求附加路径,例如 /api/v1/...默认值: https://mtrkr.xyz. |
此包今天没有读取其他环境变量。
MCP配置片段示例 env:
{
"mcpServers": {
"mtrkr": {
"command": "npx",
"args": ["mtrkr-mcp-server@latest"],
"env": {
"MTRKR_API_URL": "https://mtrkr.xyz"
}
}
}
}
工具索引
| # | MCP工具 | 摘要 | 主要参数 |
|---|---|---|---|
| 1 | mtrkr_resolve_name |
解决 .mega ↔ 主要的,重要的 0x |
input (姓名或地址) |
| 2 | mtrkr_wallet_quick_stats |
Tx计数在一天范围内 | address, rangeDays (1–365,默认值30) |
| 3 | mtrkr_security_scan |
审批和NFT运营商 | address |
| 4 | mtrkr_wallet_tokens |
ERC-20余额和美元 | address |
| 5 | mtrkr_wallet_nfts |
NFT持有量(上限清单) | address |
| 6 | mtrkr_lp_positions |
AMM式LP位置 | address |
| 7 | mtrkr_prism_positions |
集中流动性头寸 | address |
| 8 | mtrkr_inspect_address |
EOA/合同检查 | address |
| 9 | mtrkr_token_scan |
ERC-20风险扫描 | address — ERC-20代币合约 (不是钱包) |
| 10 | mtrkr_decode_transaction |
解码交易 | hash |
| 11 | mtrkr_eth_price |
ETH/USD | (无) |
| 12 | mtrkr_companion_get |
一个钱包分析快照 | address;可选 whichWave, waveId,或兼容性别名 wave — 终端波形日历 |
| 13 | mtrkr_companion_analyze |
分析+可选点对齐 | address;可选 points;可选 whichWave, waveId,或兼容性别名 wave |
| 14 | mtrkr_companion_compare |
最多可比较5个钱包 | addresses (1–5);可选的 pointsByAddress;可选 whichWave, waveId,或兼容性别名 wave |
安全和限制
输出为 信息性的 --风险评分、批准、定价、NFT/DeFi估值和解码的调用数据取决于索引器、神谕、启发式方法和第三方提要。 缺口 有可能(合同不标准、索引延迟、元数据丢失、API中断)。
不是投资建议。 将令牌示例(蜜罐、销售模拟)视为 风险信号,而不是买入/卖出建议。在采取行动之前,使用独立工具确认关键发现。
工具
身份
名称解析 — 工具: mtrkr_resolve_name
解决a .mega 名称到钱包地址,或钱包地址到其主地址 .mega 名字。通过MTRKR进行链上名称解析。
试着问:
- “miracy.mega是什么地址?”
- “0x1234…abcd有.mega名称吗?”
- “解决海市蜃楼。mega”
钱包投资组合
代币余额和定价 — 工具: mtrkr_wallet_tokens
发现钱包中持有的ERC-20代币,包括余额、美元定价和元数据。使用混合发现(令牌列表多呼叫加传输日志式扫描),因此 许多 即使令牌不在默认列表中,它们也会出现;覆盖率仍然取决于RPC和索引器行为。
示例形状 (说明性;字段可能因API版本而异):
{
"tokens": [
{
"address": "0x…",
"symbol": "USDM",
"name": "…",
"balance": 100.0,
"balanceUsd": 100.0,
"priceUsd": 1.0
}
],
"totalUsd": 1234.56
}
试着问:
- “mirage.mega持有哪些代币?”
- “显示0x1234…abcd的令牌组合”
- “0xdead…牛肉代币的总美元价值是多少?”
- “这个钱包里有美元吗?”
NFT持股 — 工具: mtrkr_wallet_nfts
MegaETH上的NFT(ERC-721、ERC-1155、ERC-404)。数据来自链索引器、市场提要、徽章和枚举。返回高达 25 使用可用底价元数据订购的商品。 底价和属性 取决于市场/索引器的可用性,可能已经过时或不存在。
试着问:
- “mirage.mega拥有哪些NFT?”
- “显示0x1234…abcd的NFT集合”
- “这个钱包里有Fluffle NFT吗?”
- “0xdead…牛肉中NFT的底价是多少?”
活动摘要(快速统计) — 工具: mtrkr_wallet_quick_stats
可配置范围(1-365天)内的交易计数(入/出/合计)。
试着问:
- “0x1234…abcd在过去90天内有多活跃?”
- “mirage.mega本周发送了多少笔交易?”
- “比较过去30天内0xdead…牛肉的入站与出站交易计数”
DeFi位置
主要AMM流动性 — 工具: mtrkr_lp_positions
支持AMM整合的活跃LP头寸:货币对、报价、流动性、无人认领的费用、美元估算。关闭的零值位置被过滤掉。使用索引器支持的数据,并在适用的情况下使用RPC回退。
试着问:
- “mirage.mega在支持的池中有哪些LP头寸?”
- “这个钱包在综合AMM头寸中提供了多少流动性?”
- “0xdead…牛肉从LP头寸中赚了多少钱?”
集中流动性 — 工具: mtrkr_prism_positions
集中流动性头寸(NFT头寸经理风格)。链上头寸读数,包括货币对、报价、区间内状态、流动性、美元估计值。
试着问:
- “mirage.mega有哪些集中的流动性头寸?”
- “显示0x1234…abcd的CL位置”
- “0xdead…beef的位置是否超出范围?”
安全与分析
批准和操作员扫描 — 工具: mtrkr_security_scan
使用粗略的风险标签和消费者上下文打开ERC-20限额和NFT操作员权限。使用历史索引 受制于 索引器的完整性、重组、非标准模式和API的可用性——将其视为一个强大的信号,而不是数学上的保证。
试着问:
- “mirage.mega的审批有风险吗?”
- “列出0x1234…abcd的所有无限审批”
- “0xdead…牛肉是否有任何关键风险代币批准?”
- “这个钱包已经批准了多少未知的消费者?”
地址检查 — 工具: mtrkr_inspect_address
检查任何MegaETH地址:EOA与合约、余额、标签、代理提示、部署者/所有者(如有)、验证、令牌接口、克隆启发式和定性风险总结。
试着问:
- “0x1234…abcd是钱包还是合约?”
- “检查0xdead…beef——它是代理吗?”
- “谁部署了合同0x5B42…d997?”
- “0xabcd…1234的源代码是否在网络资源管理器上经过验证?”
- “0x021e…782B实现了什么令牌标准?”
- “这份合同是假的吗?”
代币风险报告 — 工具: mtrkr_token_scan
多域ERC-20风险启发式(控制、退出、流动性、经济性、完整性):数字评分、发现、销售路径模拟、管理代理、集中度、管理标志等。 并非详尽无遗 --未知的漏洞利用类和数据缺口始终存在。
试着问:
- “分析令牌0x021e…782B的合约风险”
- “我可以卖0xabcd…1234吗?检查蜜罐”
- “0死牛肉的风险因素是什么?”
- “0x021e…782B的最大持有者是谁?”
- “0xabcd…1234是否具有管理员薄荷或暂停权限?”
- “0xdead…牛肉在MegaETH策划的代币列表上吗?”
钱包交易分析
周期参数:终端活动波
更喜欢 whichWave 正常使用:
whichWave: "current"--活跃终端波whichWave: "last_completed"--最近关闭的Terminal wave
使用 waveId 当你需要 特定的 历史浪潮(1 … n 来自活动配置)。 wave 保持为a 兼容性别名 (GET:字符串标记,如 current, last_completed,或映射到的数字字符串 waveId;分析/比较POST主体也可以转发字符串或数字 wave).
| 参数 | 类型 | 允许的值 | 由使用 |
|---|---|---|---|
whichWave |
可选枚举 | current, last_completed |
所有三种分析工具 |
waveId |
可选int | 来自活动配置的终端波形id | 全部三个 |
wave |
可选字符串或数字 | 兼容性别名(见上文) | 全部三个 |
工具: mtrkr_companion_get, mtrkr_companion_analyze, mtrkr_companion_compare.
条款
- 解码账簿: 出站交易 选定终端波 (
startDate–endDate来自活动配置)以及来自MTRKR解码器的方法/值上下文(如果可用)。 - 跟踪的应用程序: 当呼叫指向MTRKR应用程序目录中已知的地址时,应用程序会标记。
- 点对齐: 当您通过点时,API可能会响应启发式对齐- 不 官方积分计算。
读取分析快照 — 工具: mtrkr_companion_get
试着问:
- “为了 奇迹.mega 最后完成的终端波,总结 每次出站交易 从 解码账簿 (交换、桥梁、其他)以及映射到哪个 跟踪应用程序."
- “0x的钱包交易分析快照 周期id 3"
使用可选点进行分析 — 工具: mtrkr_companion_analyze
返回与快照工具相同的分析有效负载系列,以及可选 点对齐 供应时输出 points.
试着问:
- “我登录了 1200分 在 最后完成的终端波 --用这些数字分析钱包0x…,看看链上活动是否在同一个范围内”
比较钱包 — 工具: mtrkr_companion_compare
试着问:
- “比较mirage.mega、0xAAA…和0xBBB 当前终端波 --谁拥有更广泛的 跟踪应用程序 覆盖范围和更多的出境量?"
效用
交易解码 — 工具: mtrkr_decode_transaction
在以下情况下,人类可读的调用数据、传输、事件和合同上下文 交易数据、收据和解码器输入 可从上游服务获得。
试着问:
- “事务0xf9b5…3e2a做了什么?”
- “解码0xabcd…1234——这是交换吗?”
- “显示tx 0xdead…beef中的代币转账”
- “事务0x9876…5432中调用了什么方法?”
现货ETH价格 — 工具: mtrkr_eth_price
ETH/USD来自链上预言机(如果可用),否则为市场参考;响应包括 来源 当API提供元数据时,该工具返回 单一ETH价格,而不是金额转换——代理人或客户应在通话后乘以所需的ETH数量。
试着问:
- “MegaETH的当前ETH价格是多少?”
- “ETH价格?”
- “目前5 ETH的美元价值是多少?”
故障排除
- 工具未出现: 编辑配置后重新启动MCP主机;验证JSON;跑
node --version(20+);尝试npx mtrkr-mcp-server@latest在终端中确认包已解析。 - 过时或意外版本: 固定一个semver:
"args": ["mtrkr-mcp-server@1.1.1"]或检查dist标签:npm view mtrkr-mcp-server dist-tags. - 速率限制: MTRKR可能会返回 429;稍作等待,然后重试(分析比较更重)。
.mega未能解决: 确认名称存在,并且该标签的MTRKR解析成功。
变更日志(高级)
- 1.2.x(贝塔系数→ 稳定): 钱包交易分析
- 1.1.x: npm上较早的稳定行;看见 软件包版本.
许可证
麻省理工学院——见 package.json.