威胁情报服务器

ORKL MCP Server是一个提供ORKL威胁情报库访问的模型控制协议服务器,支持高效缓存、速率限制和Claude桌面集成。

  • by heiths
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 heiths/orkl_mcp_server

使用说明

ORKL MCP服务器

MCP(模型控制协议)服务器,用于访问 ORKL威胁情报库.

目录

特性

  • 通过以下方式访问ORKL威胁情报库数据 ORKL API
  • 高效缓存,最大限度地减少API调用
  • 遵守ORKL API限制的费率限制
  • LLM交互的标准化MCP工具和资源
  • 内置对Claude Desktop集成的支持

截图

入门指南

先决条件

  • Python 3.10或更高版本
  • 紫外线 包管理器(推荐)

安装

  1. 克隆存储库:

    git clone https://github.com/heiths/orkl_mcp_server.git
    cd orkl_mcp_server
    
  2. 使用uv安装依赖项(推荐):

    uv venv
    uv pip install -r requirements.txt
    
  3. 配置服务器(请参阅 配置 下节)

在Claude Desktop注册

将以下配置添加到您的 claude_desktop_config.json:

{
  "ORKL Threat Intelligence": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/orkl_mcp_server",  <-- Replace with the path to the cloned repository
      "run",
      "python",
      "run_server.py"
    ],
    "env": {
      "ORKL_API_BASE_URL": "https://orkl.eu/api/v1",
      "ORKL_REQUEST_TIMEOUT": "30",
      "ORKL_CACHE_TTL": "300",
      "ORKL_USE_CACHE": "1",
      "ORKL_RATE_LIMIT_REQUESTS": "90",
      "ORKL_RATE_LIMIT_PERIOD": "30"
    }
  }
}

MCP工具

服务器提供以下MCP工具:

  • fetch_latest_threat_reports:获取最新的威胁情报报告
  • fetch_threat_report_details:获取特定报告的详细信息
  • fetch_threat_report_by_hash:通过SHA1哈希检索报告
  • search_threat_reports:搜索符合条件的报告
  • get_library_info:获取有关ORKL库的信息
  • get_library_version:获取版本信息
  • fetch_threat_actors:获取所有威胁参与者的列表
  • fetch_threat_actor_details:获取威胁行为者的详细信息
  • fetch_sources:获取可用资源列表
  • fetch_source_details:获取有关来源的详细信息
  • clear_cache:清除本地缓存中的新数据

MCP资源

服务器提供以下MCP资源:

  • threat_reports://{report_id}:直接访问特定报告
  • threat_actors://{actor_id}:直接访问威胁行为者信息
  • sources://{source_id}:直接访问源信息

示例提示

恶意软件调查

我发现了一个SHA1哈希值为“5f2b7f47b2c9da342583c3a7e3887b4babad0fa9”的可疑文件。你能检查一下这个哈希值是 与ORKL数据库中的任何已知威胁相关联,并提供有关其功能和归属的详细信息?

威胁形势概述

您能否概述一下金融机构当前的威胁形势?使用ORKL API搜索 过去一个月的相关威胁报告,并确定新出现的趋势或值得注意的威胁行为体。

配置

配置可以通过以下方式提供:

  1. 环境变量
  2. JSON配置文件(config.json 在当前目录中)

环境变量

变量 描述 默认值
ORKL_API_BASE_URL API基本URL https://orkl.eu/api/v1
ORKL_REQUEST_TIMEOUT 请求超时(秒) 30
ORKL_CACHE_TTL 缓存生存时间(秒) 300
ORKL_USE_CACHE 启用缓存(1/0) 1
ORKL_RATE_LIMIT_REQUESTS 每个时段的最大请求数 90
ORKL_RATE_LIMIT_PERIOD 速率限制期(秒) 30
ORKL_CONFIG_FILE 配置文件的路径 config.json

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。