trustscoreagent

TrustScoreAgent

面向 AI 微服务的免费开放声誉注册表。Agent 在调用服务前会先查询其信任评分。

状态：第 1 阶段（早期）。 API、评分（Beta + EigenTrust）、收据验证、 Merkle 审计追踪和 MCP 服务均已实现并通过测试，但公开数据集 仍然较小（通过对公共 API 和 x402 端点进行透明探测来播种），且部分设计 （x402 支付、强制 Agent 签名）属于第 2 阶段。我们有意尽早公开发布： 面向 Agent 经济的信任层应当在成为关键基础设施之前就存在、可审计且可供采用。 请参阅 SECURITY.md 中的信任模型。

这是什么？

AI Agent 日益依赖付费微服务。TrustScoreAgent 让任何 Agent 都能：

• 查询服务声誉，然后再调用服务
• 调用服务后评价服务
• 发现哪些服务可靠

无需账户，无需 API 密钥。可通过 URL、域名或 DID 识别服务。

快速开始

# Check a service's trust score (any format works)
curl "https://api.trustscoreagent.com/v1/score?service=api.example.com"
curl "https://api.trustscoreagent.com/v1/score?service=https://api.example.com/v1/translate"

# Unknown services return a neutral score (0.5), no errors
curl "https://api.trustscoreagent.com/v1/score?service=never-seen-before.com"

# Rate a service after calling it
curl -X POST "https://api.trustscoreagent.com/v1/rate" \
  -H "Content-Type: application/json" \
  -H "X-Agent-DID: my-agent.example.com" \
  -d '{
    "service": "api.example.com",
    "metrics": {
      "status_code": 200,
      "latency_ms": 143,
      "schema_valid": true
    }
  }'

# List top-rated services
curl "https://api.trustscoreagent.com/v1/services?sort_by=score&min_ratings=10"

本地开发

# Start PostgreSQL and Redis
docker compose up -d

# Run the API
dotnet run --project src/TrustScore.Api

# Run tests
dotnet test

# Swagger UI
open http://localhost:5000/swagger

架构

• C# / .NET 8：ASP.NET Core Minimal API
• PostgreSQL：评价和服务评分
• Redis：评分缓存、速率限制、随机数追踪
• Beta 声誉系统：贝叶斯评分（按维度：可用性、延迟、符合性）
• EigenTrust：抗女巫攻击的 Agent 信任评分
• Merkle 树：带包含证明和一致性证明的审计日志（RFC 6962 树；每个叶节点都承诺了评价所报告的内容）
• Ed25519 收据验证：服务交互的加密证明
• MCP 服务：与 Claude、Cursor 和兼容 MCP 的 Agent 集成

API 参考

核心（始终免费）

端点	说明
GET /v1/score?service=	服务的信任评分（未知服务默认中立值为 0.5）
POST /v1/rate	调用服务后提交评价
GET /v1/services	列出已评分的服务（分页、排序、筛选）
GET /v1/agent/trust?did=	查询你的 Agent 信任评分
GET /v1/audit/root	最新的 Merkle 树根
GET /v1/audit/proof/{id}	评价的包含证明，以及其承诺的字段
GET /v1/audit/anchors	已锚定根的历史记录
GET /v1/audit/consistency?from=&to=	证明较新的根扩展自较早的根
GET /v1/audit/anchors/{id}/ots	OpenTimestamps 证明该根已提交至 Bitcoin
GET /v1/stats?days=	注册表的使用情况（汇总计数）

高级（目前免费，之后通过 x402 微支付）

端点	说明
GET /v1/score/history?service=	按日汇总的评分历史记录
GET /v1/score/detailed?service=	延迟百分位数、质量分布
POST /v1/scores/bulk	单次请求最多查询 100 个评分

服务识别

所有端点都接受任意格式的服务标识（内部会进行规范化）：

• api.example.com（域名）
• https://api.example.com/v1/translate（URL）
• did:web:api.example.com（DID）

三种格式都会解析到同一服务。

MCP 服务

TrustScoreAgent 可作为 MCP 服务供 Claude、Cursor 和其他 Agent 使用。

# Add to Claude Code
claude mcp add trustscoreagent -- npx -y @trustscoreagent/mcp-server

在向 x402 端点付款之前，使用收到的 402 响应中的 pay_to 调用 check_reputation，即可查询注册表是否见过该收款方。完整设置说明请参阅 docs/mcp.md。 该服务也已列入 官方 MCP Registry （io.github.trustscoreagent/mcp-server）、npm、 Smithery 和 Glama；每个 GitHub 版本发布都会附带一个供 Claude Desktop 使用的 .mcpb 包。

x402 插件

@trustscoreagent/x402 可接入 x402 客户端 SDK（@x402/core，供 @x402/fetch 和 @x402/axios 使用）。每次付款前，它都会检查收款方是否与注册表在该端点记录的收款方一致；若不一致，就会在签名之前阻止付款。

const guard = trustScoreGuard();
guard.attach(client, http);
const fetchWithPayment = wrapFetchWithPayment(guard.wrapFetch(fetch), http);

除非设置 minScore，否则评分本身不会阻止付款；除非设置 failClosed，否则无法访问注册表也不会阻止付款；付款后评分为可选操作（rate: true）。它运行在你的 Agent 中：请求不会经过 TrustScoreAgent。参见 x402-plugin/README.md。

框架集成

适用于 Agent 框架的即插即用工具（无需账户或 API 密钥）：

• LangChain：from trustscoreagent_langchain import get_trustscoreagent_tools
• CrewAI：from trustscoreagent_crewai import get_trustscoreagent_tools

每个集成都提供 trustscore_check_reputation、trustscore_submit_rating 和 trustscore_list_services。参见 integrations/。

文档

• API 参考
• 示例与操作指南
• 收据标准
• MCP 服务设置：Claude、Cursor、Windsurf
• x402 插件：付款前检查收款方
• Agent 信任为何重要
• 隐私与数据处理
• 审计日志规范，并提供了独立验证工具： tools/verify-proof

参与贡献

欢迎贡献：请参阅 CONTRIBUTING.md 和我们的 行为准则。如需报告漏洞，请按照 SECURITY.md 中的说明操作。

项目状态与信任模型

TrustScoreAgent 目前处于 第 1 阶段（早期）。具体来说：

• 基准数据真实且可审计。 初始评分来自透明运行的探测器 （did:web:trustscoreagent.com:probe），用于衡量一份精选的公开免费 API 清单，以及 Agent 付费最多的 x402 端点的可用性、延迟和符合性（每日从公开 Bazaar 目录中挑选，并在不付款的情况下进行探测，参见 docs/x402-probe.md）：这些都是真实且经过 Merkle 审计的测量结果，并非编造的数据。对于这些 x402 端点，评分还会注明其要求的收款地址和价格，以及其中任一项最近一次变更的时间。社区评分和经收据验证的评分会在此基础上累积。（此前虚构的 *.example.com 种子数据已移除。）
• 单一运营方。 目前，中立性依赖开源评分代码和可验证的 Merkle 审计轨迹，而非去中心化。联合运行属于后续阶段。
• Agent 身份可验证，但尚非强制要求。 以 did:key 标识的 Agent 会使用其 Ed25519 密钥为每条评分签名（X-Agent-Signature），从而将评分绑定到该密钥的持有者。未签名的评分仍按一半权重计入，以便现有客户端继续运行；这意味着评分的可归属程度取决于其签名。 经验证的服务收据仍是最有力的信号。

完整信任模型及漏洞报告方式，请参见 SECURITY.md。

许可证

Apache-2.0。参见 LICENSE。