Crowdsentinel MCP Server

社区

AI驱动的威胁狩猎与事件响应MCP服务器，连接Elasticsearch/OpenSearch。

分类: 数据库第 20 / 58
Stars: ★ 204 非常热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Python · 预编译二进制
凭据: 需要 API Key / 凭据
许可证: GPL-3.0
最近提交: 3 个月前

59FMRS · C

CrowdSentinel MCP服务器为Elasticsearch/OpenSearch提供了全面的AI驱动威胁狩猎和事件响应能力，拥有丰富的工具集、大量检测规则和多源集成。然而，其开发状态、安全配置默认值以及潜在的敏感数据访问使得它更适合研究和测试环境，而非生产环境。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

13/20

文档质量

12/20

安装易用性

14/20

查看各项评分依据

可靠性 8/20: 仓库包含一个分层的测试套件（tests/ 下有单元/集成/API/E2E/系统层级）、Makefile 中的 make test-unit / make test-integration 等目标，并提到用 testcontainers 启动真实 Elasticsearch，这些是 README 中可复述的证据，表明服务器启动与 MCP 握手路径有被覆盖的意图。服务器清单声明了 pypi 包 crowdsentinel-mcp-server 0.6.0 和 stdio 传输，与 README 声称的 139 个工具、9 个资源、4 种传输模式大体一致。但本次静态评审只看到 README 与清单，没有任何实际 CI 工作流文件或测试日志，无法验证这些测试真实运行，因此不能给予可靠性上限以上的分数。此外，包体很大（约 113 MB）且依赖 Velociraptor、osquery、tshark、Chainsaw 等可选组件，工具按条件注册，声明数量与实际行为是否一致存在不确定性。扣分原因是缺少可验证的执行证据和故障路径证据，得 8 分。
安全与权限 12/20: 凭据处理未见硬编码：清单支持 API key、用户名/密码、bearer token，并正确标记 isSecret；README 中的安装示例不包含真实令牌。高危写操作可通过 DISABLE_HIGH_RISK_OPERATIONS=true 隐藏（create_index、delete_index、index_document、delete_by_query 等），HTTP 传输声称有 Origin 校验（防 DNS rebinding）和传输层审计日志。但快速入门示例默认使用 VERIFY_CERTS=false，即关闭 TLS 证书校验，虽然生产配置部分明确建议改为 true 并配置 CA。仅凭 README 与清单，无法从代码层面验证这些安全机制真实生效；且破坏性操作为默认可用、仅靠环境变量禁用。未发现恶意负载、凭据窃取或隐蔽外传的迹象；也未触发现有红线的明确证据。因默认配置偏宽松且无代码级验证，扣分后得 12 分。
维护活跃度 13/20: 维护证据包括：许可证明确（GPL-3.0）、版本号 0.6.0、已发布的 PyPI 包、README 和 CHANGELOG 引用、仓库未归档、开放 issue 仅 1 个。这些表明项目处于活跃状态。但静态材料中没有提交历史、发布标签、依赖更新节奏或 issue 响应记录，无法证实持续维护的治理质量。因此分数反映的是存在许可证、版本和发布渠道的事实，同时扣除了不可验证的定期维护证据，得 13 分。
文档质量 12/20: README 覆盖面广：快速开始、pip/uv/uvx/源码安装、多个客户端（Claude Code、Claude Desktop、VS Code、Cursor、Roo Code、5ire、通用 MCP）的配置示例、环境变量表（含生产环境安全警告）、工具分类、传输模式、CLI 命令、doctor 排障命令。文档分层且有具体示例，属于高质量 README。但很多数字是自我报告且无法静态验证（139 个工具、6,060 条规则、8GB FIFO），且没有逐工具的参数权威清单，也没有独立的故障排查和限制说明章节可交叉核对。因此得 12 分，扣分原因是过度依赖不可信的 README 声明和缺少可核验的参数/边界证据。
安装易用性 14/20: 安装路径清晰多样：PyPI pip/uv/uvx、源码 setup.sh，各主流 MCP 客户端都有现成的 JSON/命令配置示例，并提供 crowdsentinel doctor 做离线就绪检查。从环境变量到连接成功的步骤在文档中可复现。但静态材料中没有可验证的 CI 安装执行证据，且完整功能需要额外系统依赖（tshark 约 132 MB）和 Velociraptor/osquery 等可选集成，真实全功能安装比快速开始更复杂。静态校准上限为 15，综合扣分后得 14 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件执行命令或代码访问网络连接数据库

适合谁

安全分析师在Elasticsearch或OpenSearch环境中进行威胁狩猎
事件响应人员需要AI辅助调查工作流
红队/安全测试人员需要分析攻击模拟数据
研究人员使用Cybersentinel-range等cyber range环境

不适合谁

生产环境（明确警告不适用于生产）
非安全背景的用户（针对DFIR专业人员）
需要Splunk集成（仍在路线图中）的用户
依赖单一数据源（与多个源集成）的用户

所需权限

需要Elasticsearch/OpenSearch凭据（API密钥或用户名/密码）
可读取和写入Elasticsearch索引（可通过DISABLE_HIGH_RISK_OPERATIONS限制）
需要访问外部威胁情报服务（VirusTotal、Shodan等）的可选API密钥
需要本地系统权限运行osquery和tshark等工具
需要Velociraptor API配置进行端点取证

风险与副作用

高权限操作：可创建/删除索引、文档、数据流和别名
潜在敏感数据暴露：搜索可能返回包含个人身份信息或敏感安全数据的文档
TLS验证默认关闭（VERIFY_CERTS默认false），存在中间人攻击风险
外部服务依赖：需要访问威胁情报API，可能产生费用或速率限制
积极的开发状态：API可能变化，不适合生产使用

安装接入

准备工作

运行环境：Python · 预编译二进制

ELASTICSEARCH_API_KEY 可选密钥 Elasticsearch API 密钥，生产与云环境推荐使用；在 Elasticsearch 集群中生成。

ELASTICSEARCH_PASSWORD 可选密钥基本认证密码，与 ELASTICSEARCH_USERNAME 配合使用。

ELASTICSEARCH_BEARER_TOKEN 可选密钥服务/Bearer 令牌，认证优先级最高，可替代 API 密钥。

ELASTICSEARCH_CLIENT_KEY 可选密钥 mTLS 客户端私钥路径。

VIRUSTOTAL_API_KEY 可选密钥 VirusTotal API 密钥，免费层每天 500 次查询；可选。

ABUSEIPDB_API_KEY 可选密钥 AbuseIPDB API 密钥，免费层每天 1,000 次查询；可选。

THREATFOX_API_KEY 可选密钥 abuse.ch ThreatFox API 密钥，免费层无限制；可选。

MISP_API_KEY 可选密钥 MISP API 密钥（40 位十六进制）。

ANTHROPIC_API_KEY 可选密钥 CLI `analyse --mcp` 智能体模式的 Anthropic 认证，可选。

OPENAI_API_KEY 可选密钥 CLI `analyse --mcp` 智能体模式的 OpenAI 认证，可选（也支持浏览器登录或本地模型）。

其他可选配置项（12 个）

ELASTICSEARCH_HOSTS 可选逗号分隔的 Elasticsearch 主机地址（如 https://localhost:9200），默认值即此。

ELASTICSEARCH_CLOUD_ID 可选 Elastic Cloud 部署 ID，云部署时替代 ELASTICSEARCH_HOSTS。

ELASTICSEARCH_USERNAME 可选基本认证用户名，与 ELASTICSEARCH_PASSWORD 配合使用。

VERIFY_CERTS 可选 TLS 证书验证：true（生产）、false（跳过，仅开发测试）或 CA 证书路径；默认 false。

REQUEST_TIMEOUT 可选请求超时秒数，如 30 或 10.5。

ELASTICSEARCH_CA_CERT 可选自签名证书场景下的 CA 证书路径。

ELASTICSEARCH_CLIENT_CERT 可选 mTLS 客户端证书路径。

DISABLE_HIGH_RISK_OPERATIONS 可选设为 true 隐藏 10 个高危写操作工具，实现只读访问。

MCP_ALLOWED_ORIGINS 可选 HTTP/SSE 传输下额外允许的 Origin 列表（逗号分隔），用于防 DNS 重绑定。

VELOCIRAPTOR_API_CONFIG 可选 Velociraptor API 客户端配置 YAML 路径，设置后启用 25 个端点取证工具。

MISP_URL 可选 MISP 实例 URL，用于事件导出与属性搜索；离线 JSON 导出无需此项。

MISP_SSL_VERIFY 可选自签名 MISP 实例的开发环境可设为 false。

通过pip安装：pip install crowdsentinel-mcp-server。运行crowdsentinel setup下载检测规则和工具。设置环境变量（ELASTICSEARCH_HOSTS等），并使用uvx运行服务器。可选安装velociraptor和deobf附加组件。对于标准MCP客户端，使用stdio传输；对于Web客户端，使用SSE或HTTP传输。

.mcp.json

{
  "mcpServers": {
    "crowdsentinel": {
      "command": "uvx",
      "args": [
        "crowdsentinel-mcp-server"
      ],
      "env": {
        "ELASTICSEARCH_HOSTS": "https://localhost:9200",
        "ELASTICSEARCH_API_KEY": "your_api_key",
        "VERIFY_CERTS": "false"
      }
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "crowdsentinel": {
      "command": "uvx",
      "args": [
        "crowdsentinel-mcp-server"
      ],
      "env": {
        "ELASTICSEARCH_HOSTS": "https://localhost:9200",
        "ELASTICSEARCH_API_KEY": "your_api_key",
        "VERIFY_CERTS": "false"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add crowdsentinel -e ELASTICSEARCH_HOSTS=https://localhost:9200 -e ELASTICSEARCH_API_KEY=your_api_key -e VERIFY_CERTS=false -- uvx crowdsentinel-mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 CrowdSentinel 的 139 个 MCP 工具（如 hunt_by_timeframe、get_host_activity_timeline）；也可运行 `crowdsentinel doctor` 离线校验配置，或执行 `crowdsentinel health` 确认 Elasticsearch 连接正常。

常见排障

确保已设置ELASTICSEARCH_HOSTS或ELASTICSEARCH_CLOUD_ID
验证凭据正确（API密钥或用户名/密码）
如果使用自签名证书，设置VERIFY_CERTS为true并配置ELASTICSEARCH_CA_CERT
运行crowdsentinel doctor检查配置就绪状态
对于系统依赖（如tshark），确保已安装
对于Velociraptor，设置VELOCIRAPTOR_API_CONFIG环境变量

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在过去一小时里搜寻暴力破解攻击。
显示主机 DESKTOP-ABC123 最近 24 小时的活动时间线。
我们发现了 C2 信标，接下来应该猎捕哪些相邻 kill chain 阶段？
分析这个 PCAP 文件，检测是否存在 C2 beaconing。

使用场景

使用自然语言搜索Elasticsearch中的威胁

执行检测规则并映射MITRE ATT&CK技术

使用Velociraptor收集端点取证工件

分析PCAP文件中的C2信标

使用Chainsaw和Sigma规则狩猎EVTX日志

跨SIEM和端点源关联IoC

支持客户端

Claude Code

Claude Desktop

VS Code

Cursor

Roo Code

5ire

依据项目文档列出，未经本站实测。

详细介绍

CrowdSentinel MCP服务器是一个开源威胁狩猎编排器，通过Model Context Protocol (MCP)将大语言模型连接到企业安全数据。它提供139个MCP工具，包括自然语言威胁狩猎、检测规则执行（6,060条内置规则）、端点取证（Velociraptor）、主机取证（osquery）、EVTX日志分析（Chainsaw）和PCAP网络分析（Wireshark）。支持多种安全框架（Cyber Kill Chain、Pyramid of Pain、Diamond Model、MITRE ATT&CK），并具有持久化调查状态、跨工具IoC关联和编码命令去混淆功能。该服务器旨在用于安全测试、研究和教育目的，非生产环境就绪。