内容
# agentforge-trust-mcp
[](https://www.npmjs.com/package/agentforge-trust-mcp)
[](https://www.npmjs.com/package/agentforge-trust-mcp)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
**一个 MCP 连接 → 100+ MCP 服务器，具备信任审计、发现和执行功能。**
AgentForge 为任何代理提供单一连接，暴露整个 MCP 服务器目录 — 信任评分、可搜索和可执行。信任评分（0-100）根据五个维度计算：代码健康、安全扫描、行为审计、社区信任和欧盟合规性。
`v0.3.0` 版本包含 **8 个工具**（4 个信任工具 + 4 个动作工具），以及一个 **P0 RCE 净化层**（输入验证、调用守卫、异常检测），具备 **27/27 测试通过** 和 **零外部运行时依赖**。
> 📖 **外部多代理系统完整集成指南：**
> 请参阅 [agentforge.community/trust](https://agentforge.community/trust) 了解完整的集成指南
> — OpenClaw、Claude Desktop、Cursor、LangGraph、AutoGen、CrewAI 约 3 分钟。
## 安装
```bash
npx -y agentforge-trust-mcp@latest
```
### Claude Desktop / Cursor / OpenClaw 配置
```json
{
"mcpServers": {
"agentforge": {
"command": "npx",
"args": ["-y", "agentforge-trust-mcp@latest"],
"env": {
"AGENTFORGE_API_URL": "https://agentforge.community",
"AGENTFORGE_API_KEY": "af_agent_REPLACE_AFTER_REGISTRATION"
}
}
}
}
```
> 信任工具（`check_trust`、`evaluate_policy`、`list_trusted`、`recommend`）
> 无需 API 密钥即可工作。动作工具（`broadcast_search`、`call_tool`）
> 需要通过 `register_agent` 自行注册（一次工具调用，无需注册）。
### 环境
| 变量 | 默认值 | 目的 |
|---|---|---|
| `AGENTFORGE_API_URL` | `https://agentforge.community` | 自托管的重写 |
| `AGENTFORGE_API_KEY` | 无 | 企业级（私有目录、自定义策略） |
## 工具
### 信任工具（无需身份验证）
#### `check_trust`
返回由 `server_id`、`slug` 或 `github_url` 标识的服务器的 AgentForge 信任评分。在连接到新服务器之前始终调用此函数。
#### `evaluate_policy`
允许/拒绝门控。传递一个策略，如 `{min_overall: 70, required_badges: ["actively_maintained"]}`
并返回 `allowed: true|false`，附带每个检查的详细信息。
#### `list_trusted`
在 AgentForge 目录中搜索匹配类别和信任阈值的服务器。对于“查找一个安全的数据库 MCP 服务器，其整体评分 ≥ 80”非常有用。
#### `recommend`
自然语言搜索，带有信任过滤器。“我需要验证捷克增值税 ID”
返回按最低信任度过滤的排名结果。
### 动作工具（新增于 v0.2.0）
#### `discover`
浏览整个目录，支持全文或语义搜索。返回按信任评分、类别和连接元数据排名的结果。无需 API 密钥
— 只读目录访问。
#### `broadcast_search` *(API 密钥)*
一次调用跨多个服务器运行单个查询。AgentForge 负责搜索、聚合结果并返回统一的排名列表。通过钱包进行按次计费。
#### `call_tool` *(API 密钥)*
通过 AgentForge 的代理在目录中的任何服务器上调用任何工具。
一个连接，数百个下游服务器 — 代理处理身份验证、配额和信任门控。
#### `register_agent`
自行注册您的代理并接收 `af_agent_*` API 密钥。无需人工
注册，无需仪表盘 — 第一次工具调用返回密钥。传递 `name`、
`description`、`capabilities`，可选 `homepage_url` 和 `metadata`。
## 用例
### 连接前信任审计
```
代理：用户要求我使用“some-financial-mcp”服务器。
代理：让我先检查其信任度……
→ check_trust(slug="some-financial-mcp")
← overall_score: 42, badges: [], security_scan: pending
代理：信任度太低，跳过。让我找一些替代方案。
→ recommend(query="invoice conversion Czech VAT", min_overall=75)
← 3 个结果，评分为 87、84、79
代理：连接到评分为 87 的服务器。
```
### 一个连接，100+ 服务器（v0.2.0）
```
代理：我需要航班 + 天气 + 货币数据用于行程规划。
代理：注册一次，如果我还没有……
→ register_agent(name="TripPlanner", capabilities=["travel"])
← af_agent_xyz123
代理：广播到 travel 标签的服务器。
→ broadcast_search(query="flights Prague→Tokyo May 15", category="travel")
← 来自 4 个服务器的结果，所有信任度 ≥ 75
代理：通过代理调用顶部结果。
→ call_tool(server="skyscanner-mcp", tool="search_flights", args={...})
← 预订结果
```
无需安装或配置单个 MCP 服务器 — 一个连接到 AgentForge，您的代理即可访问整个目录。
## 信任维度
| 维度 | 权重 | 来源 |
|---|---|---|
| 安全扫描 | 30% | Snyk、GitHub Advisory、秘密扫描 |
| 代码健康 | 20% | 提交频率、问题比率、许可证 |
| 行为审计 | 20% | Claude 驱动的源代码审查、红旗检测 |
| 社区信任 | 15% | 星标、复刻、作者声誉 |
| 欧盟合规性 | 15% | GDPR、AI 法案、数据驻留 |
审计每 14 天轮换一次；`evaluate_policy` 如果不是
所有维度都是当前状态，则报告 `partial: true`。
## 许可证
MIT — AgentForge 2026
