ORKL MCP Server

ORKL MCP サーバー

ORKL Threat Intelligence Libraryにアクセスするための MCP（Model Control Protocol）サーバーです。

目次

• 機能
• はじめに
  • 前提条件
  • インストール
  • 設定
• MCP ツール
• MCP リソース
• プロンプトの例
• ライセンス

機能

• ORKL APIを介してORKL Threat Intelligence Libraryのデータにアクセスできます
• API 呼び出しを最小限に抑える効率的なキャッシュ
• ORKL APIの制限を遵守するレート制限
• LLMとのやり取りに対応した標準化済みの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か月の関連する脅威レポートを検索し、 新たな傾向や注目すべき脅威アクターを特定してください。

設定

設定は次の方法で指定できます：

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の下でライセンスされています。詳細はLICENSEファイルを参照してください。