デバイス連携ブロックエージェント

これは、AFデバイス連携ブロック機能に接続するために、FastMCPの最新バージョンに基づいて構築されたAiPy拡張用スキャフォールドです。

プロジェクト構造

• device_block_agent/：コアPythonソースコードおよびMCPツール実装。

• docs/：API整理ドキュメント、計画書、および元のPDF。

• assets/：アイコンなどの静的リソース。

• examples/：ホワイトリストのサンプルおよび参考資料。

• ルートディレクトリ：main.py、manifest.json、requirements.txt、README.mdなどのプロジェクトエントリーファイルを保持。

現在のステータス

• FastMCP 3.2.4を統合済み。

• Streamable HTTP MCPサービスエントリーを提供済み。デフォルトの公開パスは /mcp。

• AiPyが必要とする addition-system-instruction プロンプトを提供済み。

• auth_login、auth_keepalive、auth_logout の3つの認証ツールを提供済み。

• block_list_temp、block_list_business、block_get_total_count、block_get_block_time の4つの読み取り専用クエリツールを提供済み。

• ホワイトリストルールの読み込みおよび手動確認判定モジュールを提供済み。後続の書き込み操作ツールで直接再利用可能。

• block_add_business、block_delete_temp、block_delete_business、block_clear_attackers、block_clear_temp、block_clear_business、block_set_block_time の7つの書き込み操作ツールを提供済み。

• ローカルJSONL監査ログおよび操作タイプ別に詳細化された再チェック結果を提供済み。

• ローカルJSONファイルによるログインセッションの永続化をサポートし、プロセス間でのログイン状態の再利用が可能。

• ローカルセッションのタイムアウト判定および期限切れ間近の自動keepaliveをサポート。

• デフォルトのAFアカウントおよび接続設定をサポートし、認証およびブロックツールで直接再利用可能。

• AiPyからMCPサービスへの検出リンクを検証するための最小限のツール agent_info を提供済み。

• 初版のビジネスレベル再チェック戦略を統合済み。block_clear_attackers は前後ベースライン比較判定にアップグレード済み。

ローカル実行

1. 依存関係のインストール：pip install -r requirements.txt

2. サービスの起動：python main.py

3. サービス起動後、標準出力にランダムなポート番号が表示されます。

リスク管理設定

1. examples/whitelist.sample.json にローカルホワイトリストのサンプルを提供。

2. confirm_mode は manual と auto の2つのモードをサポート。

3. WHITELIST_FILE および CONFIRM_MODE は manifest.json の user_config を通じて実行環境に注入可能。

4. クリア系の操作は常に明示的な確認を要求。一括追加、一括削除は manual モードで明示的な確認を要求。

5. LOG_FILE はローカルJSONL監査ログのパスを指定するために使用可能。

6. SESSION_FILE はローカルJSONセッション永続化パスを指定するために使用可能。

7. SESSION_TIMEOUT_SECONDS および SESSION_REFRESH_WINDOW_SECONDS は、ローカルセッションのタイムアウトおよび自動キープアライブウィンドウを制御するために使用可能。

アカウント設定

1. af_host はデフォルトのAFホストアドレスを設定するために使用。

2. af_namespace はデフォルトの名前空間を設定するために使用（デフォルトは public）。

3. af_username および af_password はデフォルトのログインアカウントを設定するために使用。

4. af_verify_tls はデフォルトのHTTPS証明書検証スイッチを設定するために使用。

5. 設定完了後、auth_login、auth_keepalive、auth_logout およびブロック関連ツールはこれらのデフォルト値を直接再利用可能。

現在実装済みのツール

1. agent_info

2. auth_login

3. auth_keepalive

4. auth_logout

5. account_config_status

6. block_list_temp

7. block_list_business

8. block_get_total_count

9. block_get_block_time

10. block_add_business

11. block_delete_temp

12. block_delete_business

13. block_clear_attackers

14. block_clear_temp

15. block_clear_business

16. block_set_block_time

次のステップ

1. 本番環境への導入が必要な場合、ログローテーションおよび機密フィールドの階層化マスキングを追加する。

2. より強力な再チェック能力が必要な場合、ビジネスレコードIDまたは操作結果オブジェクトに基づく正確な比較を追加する。

3. 長期運用が必要な場合、トークン失効後の自動再認証戦略を追加する。