agent-trust-mcp

Name: agent-trust-mcp
Author: Nikoble1926

本地服务

github.com/Nikoble1926AI 与智能体16 周前更新

代码仓库

关于 agent-trust-mcp

agent-trust-mcp 将 Agent Trust Oracle 接入 MCP 客户端，用于查询 ERC-8004 Agent 信任评分。它提供无需钱包密钥的免费预览，也可通过 x402 付费获取带签名的评分。

主要功能

01免费获取示例评分预览
02查询 ERC-8004 Agent 评分
03提供评分组成明细
04支持五条区块链网络
05返回签名结果供验证
06x402 自动支付 USDC

适用场景

01在 MCP 客户端查看 Agent 信任预览
02查询指定链上的 Agent 评分
03验证付费评分的签名结果

MCP 相关

该 MCP 服务向客户端提供免费预览和付费评分工具。付费调用可使用本地配置的 Base 钱包密钥，通过 x402 以 USDC 支付。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "nikoble1926-agent-trust": {
      "command": "npx",
      "args": [
        "-y",
        "@nikosble1926/agent-trust-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "RESOURCE_SERVER_URL": "<RESOURCE_SERVER_URL>"
      }
    }
  }
}

启动命令npx -y @nikosble1926/agent-trust-mcp

需要配置的环境变量

EVM_PRIVATE_KEY密钥Optional. Base wallet private key (0x...) for a low-balance hot wallet with a little USDC. Required only for the paid tool; the free get_trust_preview works without it. Never use your main wallet.

RESOURCE_SERVER_URLOptional. Override the trust API base URL. Defaults to https://trust.nsgoods.org.

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

安装包

npm@nikosble1926/agent-trust-mcp1.0.0stdio

工具

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

此工具无需参数。

详细介绍

Agent Trust Oracle MCP

将 Agent Trust Oracle 作为工具接入 Claude Desktop、Cursor 或任何 MCP 客户端。向你的 Agent 查询 ERC-8004 信任评分，它就会调用该工具；使用付费工具时，桥接服务会通过 x402 自动使用 Base 上的 USDC 付款，并返回已签名的结果。

get_trust_preview 工具免费使用，无需钱包密钥。付费工具每次调用只需几美分，只有设置了 Base 钱包密钥后才会启用。

快速开始（无需克隆，无需构建）

将以下内容添加到客户端配置中即可——npx 会获取并运行它：

Claude Desktop — Settings → Developer → Edit Config：

{
  "mcpServers": {
    "agent-trust": {
      "command": "npx",
      "args": ["-y", "@nikosble1926/agent-trust-mcp"]
    }
  }
}

这样即可直接使用免费预览。要启用付费工具，请添加余额较少的 Base 钱包密钥：

{
  "mcpServers": {
    "agent-trust": {
      "command": "npx",
      "args": ["-y", "@nikosble1926/agent-trust-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x<your-low-balance-base-wallet-private-key>"
      }
    }
  }
}

Cursor — Settings → MCP → Add new server，使用相同的 command/args/env。

重启客户端，然后询问："获取 Agent 信任预览"（免费），或 "获取 ethereum 上 Agent 6976 的信任评分"（付费）。

工具

工具	费用	描述
`get_trust_preview`	免费	ERC-8004 Agent 信任评分示例（0–100），包含各项指标明细，无需钱包密钥
`get_agent_trust`	$0.005 USDC	单个 Agent 的已签名 ERC-8004 信任评分（0–100）和各项指标明细（客户端广度、近期程度、价值、交易量）。参数：`agent`（uint256 ID，例如 6976）、`chain`（`base`/`bsc`/`ethereum`/`mantle`/`polygon`，默认为 `ethereum`）

付费模式（可选）

付费工具需要 EVM_PRIVATE_KEY：一个余额较少的专用热钱包的 Base 钱包私钥，其中只存放少量 USDC——切勿使用你的主钱包。付款方无需支付 gas（由 Facilitator 承担 gas），因此你主要只需准备少量 USDC。未设置密钥时，付费工具会返回清晰的“set EVM_PRIVATE_KEY”提示，免费预览仍可正常使用。

RESOURCE_SERVER_URL 为可选项，默认值为 https://trust.nsgoods.org。

从源码运行（开发）

cd mcp
npm install
npm run build
node dist/server.js   # or: npm run dev

安全

EVM_PRIVATE_KEY 属于你（买方）所有，并保留在你的客户端配置本地——绝不会发送到 API。请使用只存有少量 USDC 的一次性热钱包。
如需控制支出，请参阅官方 x402 MCP 指南中的策略检查钩子，并限制每次调用／每个会话的金额。

备注

本项目遵循官方 x402 MCP 客户端模式： https://docs.x402.org/guides/mcp-server-with-x402 。x402 v2 TypeScript 软件包（@x402/axios、@x402/evm）迭代很快——如果 npm install 或构建失败，请查看该指南以了解当前的软件包名称／版本。

信任评分读取链上的 ERC-8004 Identity + Reputation 注册表；每个付费 /agent-trust 和免费 /agent-trust/preview 响应都包含 signed_by + signature，可供验证。服务端无需账户，也无需 API 密钥。仅供学习使用——不构成财务建议。采用 MIT 许可。

支持 Markdown

登录后评论