mcp-shield

Name: mcp-shield
Author: craftedtrust.com

远程服务

github.com/cybercraftsolutionsllc安全031 周前更新

代码仓库

关于 mcp-shield

mcp-shield 提供参考实现，通过 CraftedTrust 检查来限制 Agent 连接 MCP 服务。Agent 可在决定连接前查询信任等级、发起扫描并搜索已索引的服务目录。

主要功能

01按 URL 或 npm 名称查询信任评分
02发起实时安全扫描
03搜索已索引的 MCP 服务目录
04获取生态统计数据
05发起并验证认证付款

适用场景

01在 Agent 连接前检查服务
02阻止连接信任等级为 D 或 F 的服务
03通过目录搜索查找 MCP 服务

MCP 相关

CraftedTrust 提供六种 MCP 工具，用于信任检查、安全扫描、目录搜索、统计查询和认证付款操作。仓库还包含 LangGraph 与 TypeScript 示例，展示如何依据信任等级限制服务连接。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.craftedtrust.com/api/v1/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-craftedtrust-mcp-shield https://mcp.craftedtrust.com/api/v1/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-craftedtrust-mcp-shield":{"type":"http","url":"https://mcp.craftedtrust.com/api/v1/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-craftedtrust-mcp-shield":{"type":"http","url":"https://mcp.craftedtrust.com/api/v1/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-craftedtrust-mcp-shield":{"type":"http","url":"https://mcp.craftedtrust.com/api/v1/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-craftedtrust-mcp-shield":{"serverUrl":"https://mcp.craftedtrust.com/api/v1/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
npm_name	string	否	要查询的 npm 包名称
server_url	string	否	要查询的 MCP 服务 URL

详细介绍

信任门控 Agent 示例

参考实现，展示如何让 AI Agent 在连接任何 MCP 服务之前检查 CraftedTrust。如果服务评分为 D 或 F，Agent 将拒绝连接。

这就是“AI Agent 的 SSL 证书检查”模式。

快速开始

将 CraftedTrust 添加到 Agent 的 MCP 配置中：

{
  "mcpServers": {
    "craftedtrust": {
      "url": "https://mcp.craftedtrust.com/api/v1/mcp",
      "description": "Check trust scores before connecting to MCP servers"
    }
  }
}

现在，您的 Agent 可以使用 6 个工具：

工具	描述
`check_trust`	按 URL 或 npm 名称查询信任评分
`scan_server`	触发实时安全扫描
`search_registry`	搜索 4,200+ 个已索引的 MCP 服务
`get_stats`	生态统计数据
`pay_for_certification`	发起 USDC 认证付款
`verify_payment`	验证链上付款

工作模式

在 Agent 连接任何新的 MCP 服务之前：

调用 CraftedTrust 上的 check_trust
如果评级为 D 或 F，则拒绝连接并说明原因
如果评级为 A/B/C，则继续连接

示例

Python（LangGraph）

请参阅 python/trust_gated_agent.py，了解一个完整的 LangGraph Agent，它通过 CraftedTrust 对 MCP 连接进行门控。

cd python
pip install -r requirements.txt
python trust_gated_agent.py

TypeScript（MCP 客户端）

请参阅 typescript/trust-gated-client.ts，了解一个在连接前检查信任评分的 TypeScript MCP 客户端。

cd typescript
npm install
npx tsx trust-gated-client.ts

工作原理

Agent receives task → needs mcp.example.com
         ↓
Agent calls CraftedTrust check_trust("mcp.example.com")
         ↓
Score: 82/100, Grade: B ← Safe
         ↓
Agent connects to mcp.example.com ✓

Agent receives task → needs sketchy-server.xyz
         ↓
Agent calls CraftedTrust check_trust("sketchy-server.xyz")
         ↓
Score: 15/100, Grade: F ← Dangerous
         ↓
Agent refuses: "Server scored F (15/100). Not connecting." ✗

信任评分等级

等级	分数	含义
A	90-100	安全实践优秀
B	75-89	安全状况良好，仍有小幅改进空间
C	60-74	基本合格，但存在不足
D	40-59	存在重大安全问题
F	0-39	存在严重问题，请勿连接