ORKL MCP Server

ORKL MCP 服务

一个用于访问 ORKL 威胁情报库 的 MCP（模型控制协议）服务。

目录

• 功能
• 开始使用
  • 先决条件
  • 安装
  • 配置
• MCP 工具
• MCP 资源
• 提示词示例
• 许可证

功能

• 通过 ORKL API 访问 ORKL 威胁情报库数据
• 高效缓存，尽量减少 API 调用
• 速率限制，遵守 ORKL API 的限制
• 提供标准化的 MCP 工具和资源，供大模型交互使用
• 内置 Claude Desktop 集成支持

截图

开始使用

先决条件

• Python 3.10 或更高版本
• uv 包管理器（推荐）

安装

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 许可证授权，详情请参见 LICENSE 文件。