关于 injectshield
InjectShield 的 MCP 服务让兼容客户端在将不可信文本传给大模型前检测提示词注入。它可扫描文本或网址内容,并返回检测结果及可选的脱敏版本。
主要功能
- 01扫描文本中的提示词注入
- 02抓取并扫描网址内容
- 03返回判定、置信度和威胁类别
- 04提供可选的脱敏文本
- 05列出威胁类别和扫描设置
适用场景
- 01总结前检查抓取的网页
- 02在调用大模型前检查不可信文本
- 03发现威胁后使用脱敏内容
MCP 相关
通过 `scan`、`scan_url` 和 `patterns` 工具提供 InjectShield 的扫描 API。MCP 客户端可检查文本或网址正文,并获取检测结果和可选的净化文本。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @injectshield/mcpINJECTSHIELD_API_KEY密钥API key from https://injectshield.dev (free tier: 10K req/mo).INJECTSHIELD_API_BASEOverride the API base URL for self-hosted deployments.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
3收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| text | string | 是 | 要扫描的文本(最大 100,000 个字符)。 |
| context | enum | 否 | 文本的来源。此项会影响评分——默认情况下,git 提交比用户输入更可疑。git_commit | web_content | user_input | file_content | email | tool_output | unknown |
| sensitivity | enum | 否 | 检测阈值。low = 误报最少,high = 漏报最少。默认值:medium。low | medium | high |
| return_cleaned | boolean | 否 | 返回已将检测到的片段隐去的输入文本。 |
详细介绍
@injectshield/mcp
适用于 InjectShield 的 MCP 服务——将 InjectShield 提示词注入检测 API 作为 MCP 工具提供,让任何兼容 MCP 的客户端(Claude Code、Cursor、Cline 等)都能在将不可信文本传入另一次大模型调用之前进行扫描。
工具
scan— 扫描字符串,检测提示词注入。返回判定结果、置信度、威胁类别、匹配的模式 ID,以及可选的脱敏版本(其中的注入片段已被遮盖)。scan_url— 获取 URL 并扫描其正文。自动将上下文设为web_content。patterns— 列出支持的威胁类别、上下文类型和敏感度等级。
获取 API 密钥
免费套餐:每月 10,000 次请求,无需信用卡。在 https://injectshield.dev 自助获取,密钥会通过电子邮件发送。
在 Claude Code 中安装
claude mcp add injectshield --env INJECTSHIELD_API_KEY=is_live_… -- npx -y @injectshield/mcp
在 Cursor 中安装
添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"promptshield": {
"command": "npx",
"args": ["-y", "@injectshield/mcp"],
"env": { "INJECTSHIELD_API_KEY": "is_live_…" }
}
}
}
在 Cline / 通用 MCP 客户端中安装
配置格式与 Cursor 相同。使用 Stdio 传输,命令为 npx -y @injectshield/mcp,并在 env 块中设置 INJECTSHIELD_API_KEY。
用法
安装后,你的 Agent 会获得三个新工具。请使用以下模式:
在读取获取到的网页或文件之前,先调用
scan扫描正文;如果safe为false,则停止处理。cleaned_text中的清理版本是最适合继续传递的内容。
示例(模型端推理):
User: Summarize https://example.com/article
Agent → scan_url({"url": "https://example.com/article"})
→ { "safe": false, "threat_type": "instruction_injection",
"patterns_matched": ["ignore-previous", "system-prompt-leak"],
"cleaned_text": "...[REDACTED:instruction_injection]..." }
Agent: I detected prompt-injection in this page. Working from the
redacted version: ...
配置
| 环境变量 | 默认值 | 用途 |
|---|---|---|
INJECTSHIELD_API_KEY | (无) | scan 和 scan_url 必需。免费获取一个。 |
INJECTSHIELD_API_BASE | https://api.injectshield.dev | 为可自托管部署覆盖此值。 |
纵深防御
InjectShield 可以降低提示词注入风险,但无法完全消除风险。请结合系统提示词加固、工具沙箱和输出过滤使用。完整模式库和更详细的讨论,请参阅主仓库。
许可证
MIT。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。