Skip to main content
Glama

SOAR MCP Server

by wuzhi-dev
GitHub
Python
MIT License
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

SOAR MCP Server

SOAR MCP Server

基于 Model Context Protocol (MCP) 的 SOAR 平台集成服务器，为 Claude Desktop、Cherry Studio、Cursor、Trae 等 AI 客户端提供安全编排、自动化和响应能力。

License: MIT Python 3.8+ MCP

功能特性 • 快速开始 • 部署指南 • API文档 • 贡献指南

概述

SOAR MCP Server 是一个创新的安全编排平台集成解决方案，通过 Model Context Protocol 将 SOAR (Security Orchestration, Automation and Response) 能力直接集成到各种 AI 客户端中，包括 Claude Desktop、Cherry Studio、Cursor、Trae 等。它提供了完整的安全事件管理、剧本执行、威胁情报查询等功能，让 AI 助手具备专业的网络安全响应能力。

核心优势

  • 🔒 安全编排：集成主流安全工具和平台

  • 🤖 AI 驱动：通过多种 AI 客户端实现智能安全响应

  • ⚡ 实时响应：快速处理安全事件和威胁

  • 🌐 Web 管理：直观的可视化管理界面

  • 🔧 灵活配置：支持多种部署和配置方式

功能特性

🛠️ MCP 工具集

剧本管理

  • list_playbooks - 获取所有可用的 SOAR 剧本列表

  • execute_playbook - 执行 SOAR 剧本

  • get_execution_status - 获取剧本的执行状态

事件管理

  • create_event - 创建新的安全事件

  • list_events - 获取安全事件列表

📊 MCP 资源

  • soar://playbooks - SOAR 剧本列表

  • soar://events - 安全事件列表

🌐 Web 管理界面

  • 剧本管理：可视化剧本列表、状态管理、执行监控

  • Token 管理：API 访问凭证的创建、管理和监控

  • 系统配置：数据库连接、同步设置、API 配置

  • 统计信息：系统状态、执行统计、性能监控

🚀 快速开始

本指南将带你从零开始部署和配置 SOAR MCP Server。

📋 环境要求

系统要求：

  • Python 3.8+

  • 4GB+ 内存

  • 网络连接（用于 SOAR API 访问）

支持平台：

  • Linux (Ubuntu 18.04+, CentOS 7+)

  • macOS (10.14+)

  • Windows 10/11

🛠️ 第一步：项目部署

1. 获取项目代码

# 克隆项目 git clone https://github.com/flagify-com/mcp-server-soar.git cd mcp-server-soar # 或直接下载发布版本 wget https://github.com/flagify-com/mcp-server-soar/releases/latest/download/mcp-server-soar.zip unzip mcp-server-soar.zip && cd mcp-server-soar

2. 环境配置

# 创建 Python 虚拟环境 python3 -m venv venv # 激活虚拟环境 # Linux/macOS: source venv/bin/activate # Windows: # venv\Scripts\activate # 升级 pip 并安装依赖 pip install --upgrade pip pip install -r requirements.txt

3. 首次启动

# 直接启动服务器 python3 soar_mcp_server.py

🎉 恭喜！服务器已启动

首次运行时，系统会自动：

  • ✅ 创建数据库和初始配置

  • ✅ 生成管理员密码（控制台会显示）

  • ✅ 启动 MCP 服务器和 Web 管理界面

  • ⚠️ 跳过 SOAR 剧本同步（需要后续配置）

重要输出信息：

🔑 管理员密码: a$bC9*xYz2M& 📊 MCP服务: http://127.0.0.1:12345/mcp 🎛️ 管理后台: http://127.0.0.1:12346/admin

⚙️ 第二步：SOAR 平台配置

1. 访问管理后台

  1. 打开浏览器，访问 http://127.0.0.1:12346/admin

  2. 使用控制台显示的管理员密码登录

  3. 点击导航栏的「系统配置」

2. 配置 SOAR 连接

在系统配置页面填入以下信息：

配置项

说明

示例值

SOAR服务器API地址

SOAR 平台的 API 基础地址

https://your-soar.com

API Token

SOAR 平台的 JWT 认证令牌

eyJhbGciOiJIUzI1NiIs...

超时时间

API 请求超时（秒）

30

同步周期

数据同步间隔

4小时

剧本抓取标签

过滤同步的剧本标签

MCP

3. 测试和保存

  1. 点击「测试连接」按钮验证配置

  2. 看到 ✅ "API连接测试成功！" 后，点击「保存配置」

  3. 系统将自动开始同步 SOAR 剧本数据

🤖 第三步：MCP 客户端配置

支持多种基于大模型的 MCP 客户端，包括但不限于：Cherry Studio、Claude Desktop、Cursor、Trae 等。

Cherry Studio（推荐）

  1. 打开 Cherry Studio

  2. 进入设置 → MCP 服务器

  3. 添加新服务器：

    { "name": "SOAR Security Platform", "type": "http", "url": "http://127.0.0.1:12345/mcp", "description": "SOAR 安全编排平台集成" }

  4. 保存并连接

Claude Desktop

编辑 Claude Desktop 的 MCP 配置文件：

位置：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

配置内容：

{ "mcpServers": { "soar": { "command": "python3", "args": ["/absolute/path/to/mcp-server-soar/soar_mcp_server.py"], "env": { "PYTHONPATH": "/absolute/path/to/mcp-server-soar" } } } }

⚠️ 重要：使用绝对路径，Claude Desktop 需要重启才能加载新配置

其他 MCP 客户端

通用配置参数：

  • 协议: Streamable HTTP

  • 服务器 URL: http://127.0.0.1:12345/mcp

  • 认证: 无需额外认证头

🧪 第四步：功能验证

验证 MCP 连接

在 MCP 客户端中输入：

请列出所有可用的 SOAR 剧本

正常情况下会返回：

📋 当前可用的 SOAR 剧本： 1. 🔍 IP信誉检查剧本 (ID: 1907203516548373) - 描述: 检查IP地址的威胁情报信息 - 状态: 启用中

执行安全剧本

请执行IP信誉检查剧本，检查IP地址 192.168.1.100

查看执行状态

查看刚才执行的剧本状态

🔧 管理工具

管理员密码重置

如果忘记了管理员密码，可以使用内置的重置脚本：

# 运行密码重置脚本 ./reset_admin_password.sh

脚本特性：

  • 🔒 安全随机密码生成（12位强密码）

  • 🎨 用户友好的彩色界面

  • ✅ 完善的环境检查和错误处理

  • 🛡️ 确认机制防止误操作

使用示例：

$ ./reset_admin_password.sh ========================================== SOAR管理员密码重置工具 v1.0 ========================================== [INFO] 🔄 开始重置SOAR管理员密码... [SUCCESS] ✅ 环境检查通过 [WARNING] ⚠️ 这将重置管理员密码，旧密码将失效 是否继续? [y/N]: y [SUCCESS] 🎉 管理员密码重置成功！ =================== 新密码信息 =================== 管理员密码: *UMiWSO7#QBe ================================================== [WARNING] 请妥善保存此密码，重启服务后生效

高级配置

环境变量配置

如需固定配置，可创建 .env 文件：

# SOAR 平台配置 API_URL=https://your-soar-platform.com API_TOKEN=your_jwt_token_here SSL_VERIFY=0 # 关闭SSL验证（默认） # MCP 服务器配置 MCP_PORT=12345 ADMIN_PORT=12346 # 高级配置 SYNC_INTERVAL=14400 # 同步周期（秒） SOAR_TIMEOUT=30 # API超时（秒）

系统服务配置

创建 systemd 服务（Linux）：

sudo nano /etc/systemd/system/mcp-soar.service
[Unit] Description=MCP SOAR Server After=network.target [Service] Type=simple User=your-username WorkingDirectory=/path/to/mcp-server-soar Environment=PATH=/path/to/mcp-server-soar/venv/bin ExecStart=/path/to/mcp-server-soar/venv/bin/python soar_mcp_server.py Restart=always RestartSec=3 [Install] WantedBy=multi-user.target
# 启用并启动服务 sudo systemctl daemon-reload sudo systemctl enable mcp-soar sudo systemctl start mcp-soar

API 文档

MCP 工具调用示例

执行安全剧本

# 通过 AI 客户端调用 "请执行钓鱼邮件响应剧本，处理邮件 attacker@evil.com" # MCP 工具调用 { "tool": "execute_playbook", "arguments": { "playbook_id": "phishing_response", "params": [ {"key": "email", "value": "attacker@evil.com"} ] } }

查询执行状态

# 通过 AI 客户端调用 "请查询剧本执行状态" # MCP 工具调用 { "tool": "get_execution_status", "arguments": { "instance_id": "1907203516548373" } }

REST API 接口

详细的 REST API 文档请参考：API 文档

测试

运行测试套件

# 运行所有测试 python -m pytest tests/ # 运行 MCP 客户端测试 cd tests python mcp_soar_client.py # 运行自动化测试 ./tests/test_automation.sh

测试剧本执行

# 使用测试数据验证剧本执行 curl -X POST http://localhost:12345/api/test/execute \ -H "Content-Type: application/json" \ -d '{ "eventId": 0, "executorInstanceId": 1907203516548373, "executorInstanceType": "PLAYBOOK", "params": [ {"key": "src", "value": "15.197.148.33"} ] }'

配置说明

环境变量

变量名

说明

默认值

必需

API_URL

SOAR 平台 API 地址

-

✅

API_TOKEN

API 访问令牌

-

✅

MCP_PORT

MCP 服务器端口

12345

❌

ADMIN_PORT

Web 管理界面端口

12346

❌

DATABASE_URL

数据库连接字符串

sqlite:///soar_mcp.db

❌

SSL_VERIFY

SSL 证书验证

1

❌

DEBUG

调试模式

0

❌

数据库配置

支持多种数据库：

# SQLite（默认） DATABASE_URL=sqlite:///data/soar_mcp.db # PostgreSQL DATABASE_URL=postgresql://user:pass@localhost/soar_mcp # MySQL DATABASE_URL=mysql+pymysql://user:pass@localhost/soar_mcp

故障排除

常见问题

1. MCP 连接失败

症状：AI 客户端无法连接到 MCP 服务器

解决方案：

# 检查服务状态 curl http://localhost:12345/health # 检查端口占用 lsof -i :12345 # 查看日志 tail -f logs/mcp_server.log

2. API 认证失败

症状：403 Forbidden 或 401 Unauthorized

解决方案：

  • 检查 .env 文件中的 API_TOKEN 是否正确

  • 确认 token 未过期

  • 验证 API 地址是否正确

3. 数据库连接问题

症状：数据库操作失败

解决方案：

# 检查数据库文件权限 ls -la soar_mcp.db # 重新初始化数据库 python -c "from models import create_tables; create_tables()"

日志分析

# 查看 MCP 服务器日志 tail -f logs/mcp_server.log # 查看 Web 服务日志 tail -f logs/web_server.log # 查看数据库操作日志 tail -f logs/database.log

贡献指南

我们欢迎社区贡献！请阅读 贡献指南 了解详细信息。

开发环境设置

# 安装开发依赖 pip install -r requirements-dev.txt # 安装 pre-commit hooks pre-commit install # 运行代码格式化 black . isort . # 运行类型检查 mypy .

提交代码

  1. Fork 项目

  2. 创建功能分支：git checkout -b feature/your-feature

  3. 提交更改：git commit -am 'Add some feature'

  4. 推送分支：git push origin feature/your-feature

  5. 创建 Pull Request

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

支持与反馈

致谢

本项目的MCP服务器实现基于 FastMCP 框架构建。FastMCP 提供了优雅的 Python MCP 服务器开发体验，让我们能够快速构建高质量的 MCP 服务器。感谢 FastMCP 团队的优秀工作！

相关链接

雾帜智能@2025 | 最牛的SOAR | OctoMation

为 AI 赋能网络安全 🔒

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrates SOAR (Security Orchestration, Automation and Response) capabilities into AI clients, enabling security playbook execution, event management, and threat intelligence queries. Provides a complete security incident response platform through natural language interactions.

  1. 概述
    1. 核心优势
  2. 功能特性
    1. 🛠️ MCP 工具集
    2. 📊 MCP 资源
    3. 🌐 Web 管理界面
  3. 🚀 快速开始
    1. 📋 环境要求
    2. 🛠️ 第一步：项目部署
    3. ⚙️ 第二步：SOAR 平台配置
    4. 🤖 第三步：MCP 客户端配置
    5. 🧪 第四步：功能验证
  4. 🔧 管理工具
    1. 管理员密码重置
    2. 高级配置
  5. API 文档
    1. MCP 工具调用示例
    2. REST API 接口
  6. 测试
    1. 运行测试套件
    2. 测试剧本执行
  7. 配置说明
    1. 环境变量
    2. 数据库配置
  8. 故障排除
    1. 常见问题
    2. 日志分析
  9. 贡献指南
    1. 开发环境设置
    2. 提交代码
  10. 许可证
    1. 支持与反馈
      1. 致谢
        1. 相关链接

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/wuzhi-dev/soar-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server