🚀 ORKL 模型控制协议（MCP）服务器

ORKL 模型控制协议（MCP）服务器可用于访问 ORKL 威胁情报库，为大语言模型（LLM）与威胁情报数据的交互提供了便捷、高效且标准化的解决方案。

🚀 快速开始

先决条件

• 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 威胁情报": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/orkl_mcp_server",  <-- 替换为您克隆仓库的实际路径
      "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"
    }
  }
}

✨ 主要特性

• 通过 ORKL API 访问 ORKL 威胁情报库数据。
• 高效缓存以最小化 API 调用次数。
• 速率限制以遵守 ORKL API 的使用限制。
• 标准化的 MCP 工具和资源用于与大语言模型（LLM）交互。
• 内置对 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. 配置服务器（参见下方的配置部分）

💻 使用示例

示例 1：获取最新的威胁情报报告

curl -X GET http://localhost:8000/api/v1/reports/latest

示例 2：搜索特定威胁情报

curl -X POST http://localhost:8000/api/v1/search \
     -H "Content-Type: application/json" \
     -d '{"query": "恶意软件"}'

📚 详细文档

MCP 工具

该服务器提供以下 MCP 工具：

• fetch_latest_threat_reports：获取最新的威胁情报报告
• fetch_threat_report：获取特定威胁情报报告
• search_threat_intel：搜索威胁情报信息
• get_indicator_details：获取指标详细信息
• retrieve_raw_data：检索原始数据
• lookup_domain：查询域名
• check_ip：检查 IP 地址
• analyze_behavior：分析行为
• generate_report：生成报告

MCP 资源

该服务器提供以下 MCP 资源：

• /api/v1/reports：用于获取和管理威胁情报报告的端点
• /api/v1/search：用于搜索威胁情报数据的端点
• /api/v1/indicators：用于获取和管理指标信息的端点

配置

所有配置可以通过以下方式指定：

1. 环境变量
2. 配置文件（config.json）
3. 命令行参数

环境变量

命令行参数

python run_server.py --help

📄 许可证

本项目使用 MIT 许可证，详细内容请参阅 LICENSE 文件。