Lovec

lovec-mcp

プロンプトインジェクション検出器 lovec.tech を利用するローカル MCP サーバーです。 エージェント（Claude Desktop、Claude Code、任意の MCP クライアント）に check_prompt_injection ツールを提供し、 信頼できないテキスト（ウェブページ、ドキュメント、ツールの結果、メール）を別の LLM に渡す前に チェックできます。

ご自身のキーのみで動作します。サーバーは何も保存、記録しませんが、 チェック対象のテキストは分析のため lovec.tech の API に送信されます。これは サイトですでに発行済みの API キーと残高を利用する薄いクライアントです。

インストール

PyPI から：

pip install lovec-mcp
# или без установки, через uv:
uvx lovec-mcp

ソースから：

cd lovec-mcp
python3 -m venv .venv
./.venv/bin/pip install -e .

キーは lovec.tech で発行できます。

手動でのクイックチェック

export LOVEC_KEY=aig_...
./.venv/bin/python server.py

export LOVEC_KEY=aig_...
./.venv/bin/python -c "
import asyncio, server
print(asyncio.run(server.check_prompt_injection('тестовый текст')))
"

MCP クライアントへの接続

Claude Desktop（claude_desktop_config.json）または Claude Code（.mcp.json）では、同じ形式を使用します：

{
  "mcpServers": {
    "lovec": {
      "command": "uvx",
      "args": ["lovec-mcp"],
      "env": { "LOVEC_KEY": "aig_..." }
    }
  }
}

ソースからインストールした場合は、uvx の代わりに venv のインタープリターと server.py へのパスを指定します：

{
  "mcpServers": {
    "lovec": {
      "command": "/absolute/path/to/lovec-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/lovec-mcp/server.py"],
      "env": { "LOVEC_KEY": "aig_..." }
    }
  }
}

コーパスのスキャンとレポート

ツールは呼び出しごとに1つの文字列をチェックします。コーパス全体（RAG、ドキュメントデータベース）のチェックには適していません。 各判定がエージェントのコンテキストを消費し、API の応答にも数秒から数分かかるためです。そのため、処理ループは CLI lovec-scan に切り出されており、エージェントは完成した概要を読み取ります。

export LOVEC_KEY=aig_...
lovec-scan ./docs --dry-run          # сколько будет запросов (= списаний), ничего не отправляет
lovec-scan ./docs --out lovec-scan-out

長いドキュメントを5000文字以下のチャンクに分割し、API に並行してリクエストを送信して、 results.jsonl に1行ずつ書き込みます。再開可能なスキャンのため、再実行すると残りの分を処理します。 失敗したチャンクはクリーンな結果ではなく、カバレッジの欠損として扱われます。402（残高切れ）が発生すると スキャンを停止し、概要に未完了の印を付けます。

出力される summary.json には、カバレッジ、ドキュメント単位のフラグ割合のウィルソン95%信頼区間（チャンク単位ではありません。 同じドキュメント内のチャンクは独立していないためです）、スコアのヒストグラム、引用付きの上位フラグが含まれます。

次に、MCP クライアントで prompt injection_scan_report を呼び出します。概要とレポートのルールが適用されます。コーパスをクリーンと呼ばないこと（フラグがゼロでも、それは上限であり、健全性の証明ではありません）、ラベルのないコーパスで precision/recall を算出しないこと、カバレッジの欠損を示すこと、フラグを確認待ちのキューとして提示することが定められています。コーパスからの引用には、信頼できないデータであることが明記されます。

フラグ	用途
--jsonl FILE	ファイルの代わりに JSONL {id, text} からドキュメントを読み込む
--ext	読み込む拡張子（デフォルトは .txt,.md,.markdown,.rst）
--workers	並行処理数。デフォルトは4
--threshold F	ベンダーの is_injection の代わりに score >= F でフラグを立てる
--limit N	ドキュメントを最大 N 件まで取得する

環境変数

変数	デフォルト	用途
LOVEC_KEY	—（必須）	lovec.tech のキー
LOVEC_BASE	https://lovec.tech	別の API ホスト
LOVEC_TIMEOUT	60	1回の呼び出しで待機する最大秒数