Orkl MCP Server

🚀 ORKL モデル制御プロトコル（MCP）サーバー

ORKLモデル制御プロトコル（MCP）サーバーは、ORKL脅威情報データベースにアクセスするためのサーバーです。

🚀 クイックスタート

ORKLモデル制御プロトコル（MCP）サーバーは、ORKL脅威情報データベースにアクセスするためのサーバーです。このサーバーを使用することで、効率的に脅威情報を取得できます。

🔧 前提条件

• 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の使用制限を遵守するためのレート制限
• 大規模言語モデル（LLM）との相互作用に使用する標準化されたMCPツールとリソース
• Claude Desktop統合のための組み込みサポート

スクリーンショット

（ここにスクリーンショットを追加する予定）

💻 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：最新の脅威情報レポートを取得する

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": "マルウェア"}'

⚙️ 設定

すべての設定は以下の方法で指定できます：

1. 環境変数
2. 設定ファイル（config.json）
3. コマンドライン引数

🌐 環境変数

💻 コマンドライン引数

python run_server.py --help

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルを参照してください。