Orkl MCP Server

🚀 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 文件。