FalconFeeds MCP server

---

通过标准化工具和资源，将实时网络安全威胁情报接入 MCP 客户端。借助与 Claude Desktop、VS Code 及其他支持 MCP 的应用程序的无缝集成，访问 FalconFeeds.io 提供的全面 IOC、CVE、TTP 和威胁行为者数据。

功能

• CVE 情报：搜索并获取通用漏洞披露（CVE）数据及详细分析
• 威胁信息源：访问来自全球来源的实时威胁情报信息源
• 威胁行为者：获取威胁行为者和网络犯罪团伙的详细档案
• 威胁图像：获取威胁信息源中的截图和视觉证据
• IOC 管理：处理入侵指标（IOC），并支持信息丰富化
• MCP 提示词：预构建的网络安全提示词，针对威胁分析工作流进行了优化

安装选项

NPX 安装（推荐）

将此服务添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "falconfeeds": {
      "command": "npx",
      "args": [
        "-y",
        "@falconfeeds/mcp@latest"
      ],
      "env": {
        "FALCONFEEDS_API_KEY": "your_api_key_here",
      }
    }
  }
}

本地开发

克隆并构建代码库，以进行开发或自定义：

git clone https://github.com/Technisanct/falconfeeds-mcp.git
cd falconfeeds-mcp

安装依赖项

npm install

构建项目

npm run build

配置 MCP 客户端：

{
  "mcpServers": {
    "falconfeeds": {
      "command": "node",
      "args": [
        "/path/to/falconfeeds-mcp/dist/index.js"
      ],
      "env": {
        "FALCONFEEDS_API_KEY": "your_api_key_here"
      }
    }
  }
}

获取 API 密钥

1. 访问 FalconFeeds 仪表板
2. 注册或登录账户
3. 前往 Settings
4. 前往 API Access
5. 生成 API key
6. 将密钥复制到环境配置中

说明

请确保您拥有有效套餐和充足的 API 额度

客户端集成

MCP 工具

CVE 操作

• get_cve_by_id：通过标识符获取指定 CVE 的详细信息
• search_cves_by_keyword：查找与特定词语匹配的 CVE
• get_cves_by_date_range：获取指定时间范围内的 CVE
• get_next_cve_page：对大型 CVE 结果集进行分页

威胁信息源操作

• get_threat_feeds：根据筛选条件获取威胁信息源

威胁行为者操作

• get_threat_actor_profile：获取包含关联信息源的全面威胁行为者档案
• search_threat_actors：搜索并筛选威胁行为者档案
• get_threat_actor_by_id：获取威胁行为者的详细信息
• search_threat_actors_by_name：按名称或别名查找行为者
• get_next_threat_actor_page：对行为者搜索结果进行分页

IOC 操作

• get_IOCs：获取所有 IOC 的详细信息
• get_IOCsThreatActors：获取与特定 IOC 相关联的威胁行为者
• get_IOCsMalwares：获取与特定 IOC 相关联的恶意软件信息

威胁图像操作

• get_threat_image：获取并显示威胁信息源报告中的视觉证据，包括截图、勒索说明和泄露数据样本

提示词模板

该服务提供面向网络安全的提示词，专为威胁情报工作流设计：

1. 威胁情报报告：生成全面的威胁报告
2. CVE 影响评估：分析漏洞影响并确定优先级
3. 事件威胁关联：将安全事件与已知威胁关联起来
4. 漏洞趋势分析：识别漏洞披露中的模式
5. 威胁狩猎操作手册：创建系统化的威胁狩猎流程
6. 供应链威胁分析：分析第三方及供应链风险
7. IOC 丰富分析：为指标补充威胁背景信息
8. 行业威胁简报：生成特定行业的威胁简报
9. 恶意软件家族分析：深入分析恶意软件特征
10. 地缘政治威胁评估：分析国家行为体和政治威胁

测试与开发

使用 MCP Inspector 测试

使用 MCP Inspector 测试服务工具和提示词：

npx @modelcontextprotocol/inspector npx -y @falconfeeds/mcp@latest

使用示例

威胁情报查询：

"Search for recent CVEs affecting Apache products with CVSS score above 7.0"

威胁行为体调查：

"Get information about APT29 and their recent campaigns targeting government sectors"

IOC 分析：

"Analyze this IP address for malicious activity: 192.168.1.100"

故障排除

常见问题

API 密钥无法使用：

• 确认已从 FalconFeeds 控制面板正确复制 API 密钥
• 确保密钥未过期或被撤销
• 检查是否已在环境配置中正确设置密钥
• 确保有足够的额度

NPX 安装问题：

• 确保已安装 Node.js 18.0.0 或更高版本
• 尝试清除 npm 缓存：npm cache clean --force
• 使用 -y 标志自动接受软件包安装

MCP 客户端连接问题：

• 更改服务配置后，重启 MCP 客户端
• 确认 JSON 配置语法有效
• 检查客户端日志中的连接错误
• 确保服务进程正常启动

获取帮助

• 文档：https://dash.falconfeeds.io/mcp/docs
• Falconfeeds API 文档：https://dash.falconfeeds.io/api/docs
• 错误报告：在 GitHub 上创建问题，并提供详细的错误信息
• 社区支持：加入社区讨论，获取帮助和建议
• 企业支持：联系 FalconFeeds 支持团队，获取企业协助

贡献

欢迎网络安全和开发社区的贡献！

开发指南

• 遵循现有代码模式和架构
• 更新工具或提示词变更的相关文档
• 确保符合 TypeScript 严格模式

许可证

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

致谢

• 基于 Model Context Protocol 构建
• 由 FalconFeeds.io 威胁情报平台提供支持
• 感谢 TypeScript 和 Node.js 生态系统的贡献者
• 感谢网络安全社区提供反馈和功能请求

---