Ironscales

Ironscales MCP 服务

用于 Ironscales 邮件安全的 Model Context Protocol（MCP）服务。支持 AI 助手调查网络钓鱼事件、管理邮件分类、执行补救操作并查看安全统计数据。

这是一个 Model Context Protocol（MCP） 服务，可将 Claude（或任何兼容 MCP 的 AI）连接到你的 Ironscales 环境。

属于 MSP Claude Plugins 生态系统的一部分 — 这是一个不断扩展的 MSP 技术栈 AI 集成套件。由 MSP 为 MSP 打造。

交互式事件卡片（MCP Apps）

ironscales_incidents_get 会在 MCP Apps 宿主（Claude Desktop/web）中呈现为交互式卡片，显示网络钓鱼事件的主题、状态、严重程度、发件人、受影响的收件人和威胁指标；在其他宿主中的纯 JSON 行为保持不变。该卡片为只读，补救操作仍由模型驱动的补救工具执行。默认采用中性样式，可通过注入 window.__BRAND__ 或设置 MCP_BRAND_* 环境变量（MCP_BRAND_NAME、MCP_BRAND_LOGO_URL、MCP_BRAND_PRIMARY_COLOR、MCP_BRAND_ACCENT_COLOR、MCP_BRAND_BG、MCP_BRAND_TEXT）进行品牌定制 — 无需重新构建。

安装

npm install @wyre-ai/ironscales-mcp

配置

设置以下环境变量：

变量	必填	说明
IRONSCALES_API_KEY	是	你的 Ironscales API 密钥
IRONSCALES_COMPANY_ID	是	你的 Ironscales 公司 ID
MCP_TRANSPORT	否	传输模式：stdio（默认）或 http

用法

使用 Claude Desktop 运行

添加到你的 Claude Desktop claude_desktop_config.json：

{
  "mcpServers": {
    "ironscales-mcp": {
      "command": "npx",
      "args": ["@wyre-ai/ironscales-mcp"],
      "env": {
        "IRONSCALES_API_KEY": "your-ironscales-api-key"
        "IRONSCALES_COMPANY_ID": "your-ironscales-company-id"
      }
    }
  }
}

使用 Claude Code（CLI）运行

claude mcp add ironscales-mcp \
  -e IRONSCALES_API_KEY=your-value \
  -e IRONSCALES_COMPANY_ID=your-value \
  -- npx -y @wyre-ai/ironscales-mcp

Docker

docker build -t ironscales-mcp .
docker run \
  -e IRONSCALES_API_KEY=your-value \
  -e IRONSCALES_COMPANY_ID=your-value \
  -p 8080:8080 ironscales-mcp

可用领域

允许列表

管理邮件允许列表和阻止列表

邮件

邮件调查和分类

事件

网络钓鱼事件管理与分诊

补救

执行邮件补救操作和隔离

统计

安全统计与报告

开发

# Clone the repository
git clone https://github.com/WYRE-AI/ironscales-mcp.git
cd ironscales-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

参与贡献

欢迎贡献！如果存在 CONTRIBUTING.md，请参阅其中的说明；也可以提交 issue 讨论更改。

许可证

本项目采用 Apache License 2.0。详情请参阅 LICENSE。