mcpField
I
injectshield

injectshield

本地服务
injectshield.dev安全021 周前更新

关于 injectshield

InjectShield 的 MCP 服务让兼容客户端在将不可信文本传给大模型前检测提示词注入。它可扫描文本或网址内容,并返回检测结果及可选的脱敏版本。

主要功能

  1. 01扫描文本中的提示词注入
  2. 02抓取并扫描网址内容
  3. 03返回判定、置信度和威胁类别
  4. 04提供可选的脱敏文本
  5. 05列出威胁类别和扫描设置

适用场景

  1. 01总结前检查抓取的网页
  2. 02在调用大模型前检查不可信文本
  3. 03发现威胁后使用脱敏内容

MCP 相关

通过 `scan`、`scan_url` 和 `patterns` 工具提供 InjectShield 的扫描 API。MCP 客户端可检查文本或网址正文,并获取检测结果和可选的净化文本。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"bch1212-injectshield": {
"command": "npx",
"args": [
"-y",
"@injectshield/mcp"
],
"env": {
"INJECTSHIELD_API_KEY": "<INJECTSHIELD_API_KEY>",
"INJECTSHIELD_API_BASE": "<INJECTSHIELD_API_BASE>"
}
}
}
}
启动命令npx -y @injectshield/mcp
需要配置的环境变量
INJECTSHIELD_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+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@injectshield/mcp0.1.4

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
textstring是要扫描的文本(最大 100,000 个字符)。
contextenum否文本的来源。此项会影响评分——默认情况下,git 提交比用户输入更可疑。git_commit | web_content | user_input | file_content | email | tool_output | unknown
sensitivityenum否检测阈值。low = 误报最少,high = 漏报最少。默认值:medium。low | medium | high
return_cleanedboolean否返回已将检测到的片段隐去的输入文本。

详细介绍

@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_BASEhttps://api.injectshield.dev为可自托管部署覆盖此值。

纵深防御

InjectShield 可以降低提示词注入风险,但无法完全消除风险。请结合系统提示词加固、工具沙箱和输出过滤使用。完整模式库和更详细的讨论,请参阅主仓库。

许可证

MIT。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。