Threat Intel MCP Server

Claudeに脅威インテリジェンスおよび脆弱性調査ツールを提供する FastMCP サーバーです。NVD、VirusTotal、AbuseIPDB、Shodan、MITRE ATT&CKと統合されています。

ツール

Related MCP server: Exploit Intel Platform MCP Server

セットアップ

1. 仮想環境を作成して有効化します:

python -m venv venv
.\venv\Scripts\Activate.ps1

2. 依存関係をインストールします:

pip install -r requirements.txt

3. APIキーを設定します — .env.example を .env にコピーし、キーを入力してください:

VIRUSTOTAL_API_KEY=your_key_here
ABUSEIPDB_API_KEY=your_key_here
SHODAN_API_KEY=your_key_here

無料のAPIキー: VirusTotal · AbuseIPDB · Shodan

Claude Desktop

サーバーは現在HTTP経由で動作するため、最初にサーバーを起動してから、URL経由で接続するようにClaude Desktopを設定してください。

1. サーバーを起動します (起動したままにしてください):

python server.py

2. %APPDATA%\Claude\claude_desktop_config.json に以下を追加します:

{
  "mcpServers": {
    "threat-intel": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

APIキーは .env から自動的に読み込まれます。

重要: Claude Desktopは起動時にのみ claude_desktop_config.json を読み込みます。設定を保存した後、Claude Desktopを完全に終了して再起動してください。実行中に変更を加えても反映されません。

MCP Inspector

サーバーはポート8000でHTTP (Streamable HTTP) を介して動作します。最初にサーバーを起動してから、インスペクターに接続してください。

1. サーバーを起動します:

python server.py

2. インスペクターを起動します:

npx @modelcontextprotocol/inspector

http://localhost:5173 を開き、トランスポートを Streamable HTTP に設定し、URL http://127.0.0.1:8000/mcp を入力します。

新しいツールの追加

1. tools/newtool.py を作成し、非同期関数を記述します

2. server.py に登録します:

from tools.newtool import my_function as _my_function

@mcp.tool()
async def my_tool(param: str) -> str:
    """Tool description shown in Inspector and to the LLM.

    Args:
        param: Parameter description
    """
    return str(await _my_function(param))

FastMCPは、シグネチャとドキュメント文字列からJSONスキーマを自動的に生成します。

APIレート制限

トラブルシューティング

JSON-RPC / EOFエラー — このサーバーはHTTPトランスポートを使用します。python server.py を直接実行して起動してください。mcp dev は不要であり、stdioベースのサーバーでのみ必要です。

APIキーが見つからない — プロジェクトルートに .env が存在することを確認してください（.env.example からコピーしてください）。起動時に、サーバーは設定されていないキーと、それらが影響を与えるツールをリストアップする警告を表示します。

レート制限エラー — 再試行するまで待機するか、有料のAPIプランにアップグレードしてください。