n8n节点spamassassin mcp
一个n8n社区节点，与 SpamAssassin MCP服务器 在n8n工作流中提供强大的垃圾邮件分析功能。
](https://github.com/btafoya/spamassassin-mcp-n8n-community-node/actions/workflows/publish.yml) ](https://www.npmjs.com/package/n8n-nodes-spamassassin-mcp)   
特性
此节点提供电子邮件安全分析的四个主要操作：
🔍 扫描电子邮件
- 分析电子邮件内容的垃圾邮件概率
- 可配置的分析级别（基本、详细、完整）
- 包含/排除标题分析
- 返回垃圾邮件评分、置信度和触发规则
🛡️ 检查信誉
- 检查发件人电子邮件信誉
- 验证IP地址信誉（可选）
- 域名信誉分析（可选）
- 跨多个来源的黑名单检查
🧪 测试规则
- 测试自定义SpamAssassin规则
- 验证规则语法和有效性
- 对个人规则贡献进行评分
- 详细的测试结果细分
📊 解释分数
- 详细的垃圾邮件评分明细
- 按规则解释
- 分类分析
- 可采取行动的建议
安装
先决条件
- SpamAssassin MCP服务器：首先安装SpamAssassin MCP服务器：
npm install -g @btafoya/spamassassin-mcp- n8n：这是n8n的社区节点。您需要安装n8n：
npm install n8n -g安装社区节点
- 通过npm （推荐）：
npm install n8n-nodes-spamassassin-mcp- 通过n8n社区节点UI:
- 转到“设置”→ 社区节点 - 点击“安装社区节点” - 输入： n8n-nodes-spamassassin-mcp - 单击安装
- 为了发展:
git clone https://github.com/btafoya/spamassassin-mcp-n8n-community-node.git
cd spamassassin-mcp-n8n-community-node
npm install
npm run build
npm link
cd ~/.n8n/nodes
npm link n8n-nodes-spamassassin-mcp配置
凭据设置
节点需要SpamAssassin MCP API凭据。您可以通过两种方式连接：
1.命令行连接（推荐）
- 连接类型：命令行
- 命令:
npx @btafoya/spamassassin-mcp（默认） - 参数：其他命令行参数（可选）
- 超时：连接超时（秒）（默认值：30）
2.HTTP/SSE连接
- 连接类型：HTTP/SSE
- 基本URL:
http://localhost:3000（默认） - API密钥：身份验证密钥（如果需要）
- 超时：连接超时（秒）（默认值：30）
启用社区节点工具使用
如果要将此节点用作n8n AI代理中的工具，请启用社区节点工具用法：
export N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
n8n start或者在你的 .env 文件：
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true使用示例
基本电子邮件垃圾邮件扫描
- 将SpamAssassin MCP节点添加到您的工作流中
- 将操作设置为“扫描电子邮件”
- 在“电子邮件内容”字段中提供电子邮件内容
- 配置分析级别（基本/详细/完整）
- 执行工作流
示例输入:
Subject: Amazing Deal - Limited Time Offer!
From: winner@suspicious-domain.com
Congratulations! You've won $1,000,000!
Click here to claim your prize now!输出示例:
{
"operation": "scan_email",
"scanResult": {
"is_spam": true,
"spam_score": 15.2,
"threshold": 5.0,
"confidence": 0.95,
"rules_triggered": [
"LOTS_OF_MONEY",
"SUSPICIOUS_DOMAIN",
"URGENT_ACTION"
],
"analysis_time_ms": 245,
"headers_analyzed": true
},
"timestamp": "2024-01-15T10:30:00.000Z"
}信誉检查
非常适合验证发件人的可信度：
- 将操作设置为“检查信誉”
- 输入要检查的电子邮件地址
- 可选择添加IP地址和域
- 执行以获得声誉分数
自定义规则测试
测试您自己的SpamAssassin规则：
- 将操作设置为“测试规则”
- 在“规则内容”中输入您的自定义规则
- 提供测试电子邮件内容
- 获取详细的测试结果和规则有效性
分数说明
了解电子邮件被标记为垃圾邮件的原因：
- 将操作设置为“解释分数”
- 提供电子邮件内容
- 如果需要，启用详细解释
- 获取逐个规则的细分
工作流集成
电子邮件处理管道
Email Trigger → SpamAssassin MCP (Scan) → Router → [Clean Email Path / Quarantine Path]基于信誉的过滤
New Contact → SpamAssassin MCP (Check Reputation) → Decision → [Allow / Block / Monitor]规则开发工作流
Rule Editor → SpamAssassin MCP (Test Rules) → Validation → [Deploy / Refine]高级配置
性能调整
- 超时：根据您的电子邮件大小和分析复杂性进行调整
- 分析水平：使用“Basic”进行大容量处理，使用“Full”进行详细分析
- 连接类型：对于本地设置，命令行通常更快
安全考虑
- 仅防御作战：此节点仅执行防御性电子邮件分析
- 无电子邮件存储：电子邮件不是由MCP服务器持久存储的
- 速率限制：MCP服务器包括内置的速率限制
- 输入验证：所有输入在处理前都经过验证
Docker集成
如果在Docker中使用n8n，请确保SpamAssassin MCP服务器可访问：
version: '3'
services:
n8n:
image: n8nio/n8n
environment:
- N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
volumes:
- ~/.n8n:/home/node/.n8n
depends_on:
- spamassassin-mcp
spamassassin-mcp:
image: btafoya/spamassassin-mcp
ports:
- "3000:3000"错误处理
该节点包括全面的错误处理：
- 连接错误：使用指数回退自动重试
- 超时处理：可配置的超时和优雅的降级
- 验证错误：清除无效输入的错误消息
- 失败后继续：批处理失败时可选择继续
故障排除
常见问题
- “连接失败”
- 验证SpamAssassin MCP服务器是否正在运行 - 检查连接凭据 - 确保网络连接
- “找不到命令”
- 安装SpamAssassin MCP服务器： npm install -g @btafoya/spamassassin-mcp - 验证PATH是否包含npm全局二进制文件
- “权限被拒绝”
- 检查文件权限 - 确保n8n有权执行命令
- “超时错误”
- 增加凭据超时时间 - 检查系统资源 - 降低分析复杂性
调试模式
启用调试登录凭据以获取详细的连接信息。
贡献
欢迎投稿！请阅读我们的 贡献指南 了解详情。
开发设置
git clone https://github.com/btafoya/spamassassin-mcp-n8n-community-node.git
cd spamassassin-mcp-n8n-community-node
npm install
npm run build
npm run lint
npm test许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
相关项目
- SpamAssassin MCP服务器 -底层MCP服务器
- n8n -工作流自动化平台
- 模型上下文协议 -AI工具集成协议