使用说明
ORKL MCP服务器
MCP(模型控制协议)服务器,用于访问 ORKL威胁情报库.
目录
特性
- 通过以下方式访问ORKL威胁情报库数据 ORKL API
- 高效缓存,最大限度地减少API调用
- 遵守ORKL API限制的费率限制
- LLM交互的标准化MCP工具和资源
- 内置对Claude Desktop集成的支持
截图
入门指南
先决条件
- Python 3.10或更高版本
- 紫外线 包管理器(推荐)
安装
-
克隆存储库:
git clone https://github.com/heiths/orkl_mcp_server.git cd orkl_mcp_server -
使用uv安装依赖项(推荐):
uv venv uv pip install -r requirements.txt -
配置服务器(请参阅 配置 下节)
在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搜索 过去一个月的相关威胁报告,并确定新出现的趋势或值得注意的威胁行为体。
配置
配置可以通过以下方式提供:
- 环境变量
- 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许可证获得许可-有关详细信息,请参阅许可证文件。