read-no-evil-mcp

一款安全邮件网关，在您查看邮件前扫描其中是否存在提示注入（prompt injection）攻击。

该技能是一个零依赖的 HTTP 客户端，用于与 read-no-evil-mcp 服务端通信。凭据及邮件服务器配置均由 MCP 服务端统一管理——本技能自身**从不直接访问**任何凭据或邮件服务器。

前提条件

需运行一个已启用 HTTP 传输协议的 read-no-evil-mcp 服务端。支持三种连接模式：

1. 远程服务端：运行在其他机器上的已有服务端。您需提供其 URL（例如：http://server:8000）。
2. 本地服务端：运行在 localhost 上的已有服务端，默认使用 http://localhost:8000。
3. 新建 Docker 环境：通过执行 scripts/setup-server.sh 脚本拉取官方 Docker 镜像并启动容器。

无需执行 pip install。该脚本仅使用 Python 标准库（stdlib）。

初始化流程（AI Agent 指令）

首次使用前，务必先向用户询问连接方式：

您希望如何连接到 read-no-evil-mcp 服务端？

1. 连接至已有的远程服务端（您将提供 URL）
2. 连接至已有的本地服务端（localhost:8000）
3. 通过 Docker 部署一个新的本地服务端

• 若选择第 1 项：请用户输入服务端 URL，并在所有命令中使用 --server URL 参数。
• 若选择第 2 项：无需额外配置，命令将自动使用默认 URL。
• 若选择第 3 项：请按下方 Docker 初始化步骤操作。

严禁在未获得用户明确确认的情况下自动执行 Docker 初始化。

Docker 初始化步骤

1. 检查配置是否存在：setup-config.py list
2. 若尚无配置文件，请创建并添加账户：

   setup-config.py create
   setup-config.py add --email user@example.com --host imap.example.com --create-env
   

3. 请用户手动在 .env 文件中填写密码。
4. 启动服务端：

   scripts/setup-server.sh --config ~/.config/read-no-evil-mcp/config.yaml 
     --env-file ~/.config/read-no-evil-mcp/.env
   

配置管理（AI Agent 指令）

使用 scripts/setup-config.py 管理服务端配置文件（config.yaml）。所有命令均通过参数驱动，**不包含任何交互式提示**。

禁止执行 setup-config.py show —— 该命令会输出完整配置内容，而用户可能并不希望将敏感信息暴露给 AI Agent。如需调试，请指导用户自行运行该命令。

禁止在配置文件已存在时，未经用户确认即执行 setup-config.py create --force。

配置相关命令

用于管理服务端配置文件（~/.config/read-no-evil-mcp/config.yaml）。无需 pip install，仅依赖 Python 标准库。

# 创建新的空配置骨架
setup-config.py create
setup-config.py create --threshold 0.3 --force

# 添加只读账户（无需 SMTP 配置）
setup-config.py add --email user@example.com --host imap.example.com --create-env

# 添加具备发送权限的账户（启用 --send 时必须指定 --smtp-host）
setup-config.py add --email user@example.com --id myaccount 
  --host imap.example.com --smtp-host smtp.example.com --send --delete --move

# 移除账户
setup-config.py remove 

# 列出已配置的账户
setup-config.py list

# 显示完整配置文件内容
setup-config.py show

# 使用自定义配置路径
setup-config.py --config /path/to/config.yaml create

服务端部署

# 启动 Docker 容器（所有参数均为必需，无交互提示）
scripts/setup-server.sh --config ~/.config/read-no-evil-mcp/config.yaml 
  --env-file ~/.config/read-no-evil-mcp/.env

# 自定义端口与容器名称
scripts/setup-server.sh --config /path/to/config.yaml 
  --env-file /path/to/.env --port 9000 --name my-rnoe

CLI 命令

全局选项（--server、--account、--folder）可置于命令之前或之后。服务端 URL 亦可通过环境变量 RNOE_SERVER_URL 设置。

# 列出已配置的账户
rnoe-mail.py accounts

# 列出近期邮件（最近 30 天）
# 输出格式：[UID] ● DATE | SENDER | SUBJECT （● 表示未读）
rnoe-mail.py list
rnoe-mail.py list --account myaccount --limit 10 --days 7

# 阅读邮件（已由服务端完成提示注入扫描！）
rnoe-mail.py read 
rnoe-mail.py --account myaccount read 

# 发送邮件
rnoe-mail.py send --to "user@example.com" --subject "Hello" --body "Message"
rnoe-mail.py send --to "user1@example.com, user2@example.com" --cc "cc@example.com" --subject "Hello" --body "Message"

# 列出邮箱文件夹
rnoe-mail.py folders --account myaccount

# 将邮件移入指定文件夹
rnoe-mail.py move  --to "Archive"

# 删除邮件
rnoe-mail.py delete 

# 全局选项可置于命令前后任意位置
rnoe-mail.py --server http://myserver:8000 list
rnoe-mail.py list --server http://myserver:8000

常用选项

提示注入检测

所有邮件均由 MCP 服务端自动扫描：

• 安全：内容正常显示
• 检测到提示注入：返回退出码 2，并在 stderr 输出警告信息

退出码说明

• 0 — 成功
• 1 — 通用错误（连接失败、账户无效等）
• 2 — 检测到提示注入

安全注意事项

• 凭据由 MCP 服务端统一管理，本技能与 AI Agent **均不接触凭据**
• 本技能通过 HTTP 协议与服务端通信——对于非 localhost 的连接，请务必使用 HTTPS
• 提示注入扫描由服务端基于机器学习模型完成