内容
# @agentscore-xyz/mcp-server
MCP安全信任层。扫描软件包，获取信任判决，检查整个仓库的MCP依赖项，生成策略门控设置，直接安装CI工作流，检查事件暴露，并查询滥用数据库。MCP安全决策的八种工具。无需API密钥，零配置。
[](https://agentscores.xyz/scan?npm=@agentscore-xyz/mcp-server)
> **扫描任意MCP软件包的安全问题：** [agentscores.xyz](https://agentscores.xyz)
## 快速开始
### Claude Desktop
将以下内容添加到您的 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"agentscore": {
"command": "npx",
"args": ["-y", "@agentscore-xyz/mcp-server"]
}
}
}
```
### Cursor / 任意MCP客户端
```bash
npx @agentscore-xyz/mcp-server
```
## 功能描述
您的AI现在可以对MCP软件包做出安全决策：
> **您：** “exa-mcp-server是否安全安装？”
>
> **Claude：** *调用get_verdict* “判决：允许。得分90/100，低风险。无出处证明（由个人账户发布）。9种工具暴露，包括web_search_exa和crawling_exa。”
> **您：** “axios软件包被泄露。哪些MCP服务器受到影响？”
>
> **Claude：** *调用check_exposure* “多个受监控的MCP服务器依赖于axios，包括exa-mcp-server、tavily-mcp和figma-mcp。”
> **您：** “扫描@azure-devops/mcp的安全问题”
>
> **Claude：** *调用scan_package* “得分75/100，中等风险。发现：预安装脚本修改npm注册表配置。无出处证明。”
> **您：** “检查此仓库的MCP依赖项”
>
> **Claude：** *调用check_my_repo* “发现MCP依赖项：5个。其中2个是警告。运行generate_policy_gate_setup将这些检查转换为CI门控。”
> **您：** “为此仓库设置AgentScore策略门控”
>
> **Claude：** *调用install_policy_gate* “工作流文件写入`.github/workflows/agentscore-policy-gate.yml`。提交并推送。GitHub OIDC将在首次运行时自动配置仓库。”
## 可用工具
| 工具 | 功能描述 |
|------|-------------|
| `scan_package` | 完整安全扫描：安装脚本、提示注入、源代码模式、出处证明、MCP工具提取 |
| `get_verdict` | 信任决策：根据扫描结果允许、警告或阻止。同时报告监控状态和发布者姿态。 |
| `check_my_repo` | 检查当前仓库的MCP依赖项并总结每个本地检测到的软件包的判决。 |
| `generate_policy_gate_setup` | 生成在CI中强制执行策略门控所需的基于OIDC的GitHub Actions工作流。 |
| `install_policy_gate` | 直接将`.github/workflows/agentscore-policy-gate.yml`写入仓库，使门控准备提交。 |
| `check_exposure` | 事件响应：哪些受监控的MCP服务器依赖于给定软件包？ |
| `check_abuse` | 查询KYA滥用数据库以获取报告的软件包或代理 |
| `monitor_status` | 检查软件包是否处于连续监控之下并获取扫描历史 |
## 从临时扫描到CI强制执行
MCP服务器现在将一次性软件包检查桥接到粘性产品：
1. 运行 `check_my_repo` 查看仓库中使用的所有MCP软件包。
2. 运行 `generate_policy_gate_setup` 预览基于OIDC的GitHub Actions工作流。
3. 运行 `install_policy_gate` 将工作流文件直接写入仓库。
4. 提交并推送。首次运行将通过GitHub OIDC自动配置仓库。
这将“此软件包是否安全？”转换为“此仓库现在在每个PR上强制执行MCP依赖项策略。”
## 风险等级
| 分数 | 风险 | 含义 |
|-------|------|---------|
| 85-100 | 低 | 仅存在干净或轻微问题 |
| 70-84 | 中等 | 存在一些发现，建议审查 |
| 50-69 | 升高 | 存在重大发现，需谨慎使用 |
| 30-49 | 高 | 存在严重问题，不推荐使用 |
| 0-29 | 严重 | 请勿使用 |
## 扫描器检查内容
- 安装脚本（postinstall/preinstall钩子带有网络调用或代码执行）
- 软件包元数据中的提示注入模式
- 可疑URL（可疑TLD、ngrok、原始IP）
- 源代码模式（命令注入、不安全eval、硬编码秘密）
- 发布者出处证明（受信任发布、证明）
- 依赖项计数和元数据完整性
- 从发布的源代码中提取的MCP工具定义
## 监控
AgentScore持续监控数百个MCP软件包。`check_exposure`和`monitor_status`工具使用此实时数据集。当axios等软件包被泄露时，您可以立即找到哪些MCP服务器受到影响。
## 链接
- **网站：** [agentscores.xyz](https://agentscores.xyz)
- **API文档：** [agentscores.xyz/docs](https://agentscores.xyz/docs)
- **方法论：** [agentscores.xyz/methodology](https://agentscores.xyz/methodology)
## 许可证
MIT
