l0g.fr Risk Intelligence

l0g.fr MCP サーバー

l0g.fr のデータ（Agent Surface、OpenAPI、Risk Diff、Black Box Recorder、NDJSON、エビデンスグラフ、クレーム、ソース、鮮度、完全性、変更フィード、シグナル履歴、分析、ガイド）を、リソース、プロンプト、リソーステンプレート、ツールを介して AI エージェントに公開する、読み取り専用の Model Context Protocol サーバーです。Streamable HTTP トランスポートを使用します（spec 2025-11-25。SSE トランスポートは非推奨です）。

対象となる公開エンドポイント：

• https://l0g.fr/api/mcp/compact：推奨される6つのツールを備えたファサード；
• https://l0g.fr/api/mcp：互換性とエキスパート向けの用途に備えて維持される完全なサーフェス。

get_risk_state はコンパクトなファサードの主要機能です。その契約では、現在の状態、1／7／30日間の差分、インストゥルメント別の履歴、および基準日、ソース、手法、制限を含む特定時点のリプレイをまとめています。

ドリフト防止契約は https://l0g.fr/api/v1/toolset-manifest.json で公開されています。

デプロイ状態

有効なバージョン、ソース SHA、アテステーションのステータスは、このドキュメントでは固定されていません。これらはリソース l0g://mcp/server で公開され、scripts/verify-public-mcp-release.mjs で検証できます。本番デーモンは、アトミックランタイム /opt/l0g-mcp-runtime/releases/ から提供されます。

再利用とライセンス

MCP 互換クライアントは、アカウントや API キーなしで公開リモートサービスを利用できます。新しい統合は https://l0g.fr/api/mcp/compact から始めてください。https://l0g.fr/api/mcp は、互換性とエキスパート向けの用途のために完全なサーフェスを維持しています。どちらも読み取り専用で、l0g.fr のデータに特化しています。

サーバーのコード、テスト、デプロイスクリプトは MIT ライセンスの下で再利用できます。サービスが返すテキスト、データ、編集成果物は、作者が保有する権利の範囲内で、クレジット表示を条件として CC BY 4.0 ライセンスの下で提供されます。第三者の素材には、それぞれ独自の権利が適用されます。リリースアーカイブ内の LICENSE と NOTICE.md を参照してください。

公開されている Linux／Node アーカイブは、l0g.fr の本番ランタイムです。監査およびこれらのライセンスに基づく再配布は可能ですが、別のコーパスやドメインをホストするための汎用 npm パッケージとしては提供されていません。

アーキテクチャ

agent / client MCP
        |  HTTPS  (Streamable HTTP, POST JSON-RPC)
        v
   Apache (443, l0g.fr)  ──reverse proxy──>  127.0.0.1:8848  (service Node, systemd)
                                                     |
                                                     | lit (lecture seule)
                                                     v
                          /var/www/html/l0g/current/agents.json
                          /var/www/html/l0g/current/openapi.json
                          /var/www/html/l0g/current/api/v1/*.json|*.ndjson
                          /var/www/html/l0g/current/risk-events.json
                          /var/www/html/l0g/current/confluence.json
                          /var/www/html/l0g/current/posts|guides/<slug>/index.html
                          /var/www/html/l0g/current/en/analysis|guides/<slug>/index.html

• Node サービスは 127.0.0.1 でのみリッスンし、直接公開されることはありません。
• データはすでにデプロイ済みのサイトから取得します：agents.json、catalog.json、 search-index.json、claims.json、evidence-graph.json、sources.json、freshness.json、integrity.json、 changes.json、risk-diff.json、black-box.json、それらの NDJSON 版、openapi.json、risk.json、debt-risk.json、 risk-events.json、confluence.json。サービスはこれらのファイルを読み取るだけです。 キャッシュはアトミックリリースの実ディレクトリに関連付けられています。シンボリックリンク current が同じリリースを指している間は保持され、切り替え後に再読み込みされます。
• ステートレス + JSON 応答モードです。保存するセッションはなく、リクエストごとに新しいサーバーとトランスポートを使用します。
• MCP 集計システムは、初期化、tools/list、呼び出し、成功／エラー、p50／p95 レイテンシ、応答サイズ、ツール、リソース、プロンプト、および clientInfo から得られる安定した分類ごとに、日別・エンドポイント別の件数を記録します。内部の l0g user-agent は集計前に除外されます。IP、セッション、フィンガープリント、user-agent 文字列、リクエスト、応答は保存されません。other に分類された正規化済みのラベルは、分類体系を修正できるよう、非公開ファイルに7日間保持されます。k=5 に達したもののみ、ローカル診断 /_l0g/mcp-client-taxonomy に表示されます。公開レポート：/api/mcp/usage。

信頼性診断

/api/mcp/usage レポートには、成功数とエラー数が保持されます。技術的な成功が示すのは、エラーが報告されていない MCP 応答があったことだけです。経済分析、情報源、結果の鮮度を検証するものではありません。

各 tools 行には、エラー数と同じ期間で集計された固定カテゴリ error_reasons が新たに含まれます。公開される各カテゴリは k=5 に達しています。errors_without_detailed_reason には、原因が記録されていない過去のエラーと、このしきい値に達していないカテゴリが含まれます。スキーマファイル 2 は、新しい内部フィールド errorReasons がなくても読み取り可能です。不明なツール名、引数、slug、応答テキスト、ネットワーク識別子は記録されません。

カテゴリ	診断アクション
invalid_arguments, invalid_date, invalid_cursor	ツールの仕様を確認します。返された不透明なカーソルと有効な暦日を使用します。
document_not_found	search_l0g または search_content で、正確な slug とその言語を検索します。
content_unavailable	アクティブなリリースに HTML ファイルが存在することを確認します。
tool_unavailable	同じ簡易または完全なエンドポイントで tools/list を再確認します。
output_contract, internal_error	該当する正確なリリースで再現し、サーバーのテストを確認します。
access_denied, rate_limited, transport_contract, invalid_request, connection_closed	保護機能を無効にせず、トランスポート、ヘッダー、制限を確認します。
tool_error, unclassified	原因はまだ特定されていません。再現できていない原因を割り当てないでください。

2026年10月8日のレポートに記載された get_document の30件と build_research_pack の32件のエラー原因は、これらの集計値だけから再構築できません。ローカルのページネーションと検証に関する修正には回帰テストがありますが、これらの過去の事象の原因を立証するものではありません。新しいリリースを比較するには、前後のキャプチャの日付とともにバージョンと SHA を記録し、既知の結果のみを対象にエラーを計算します。2つのローリングウィンドウを、2つの日付の間の正確なイベント列として混同しないでください。

ローカル診断で十分な情報が得られるまでは、クライアントカテゴリ other は不明のままです。推測でプロバイダーに割り当てないでください。申告されたファミリーとアクティブ日数は、個人や一意のインストール数を表すものではありません。

公開されるリソース

安定したドキュメントとデータセットは、MCP リソースとして公開されます。ツールは引き続き、検索、フィルタリング、要約の操作に限定されます。

静的リソース

URI	内容
l0g://agent-manifest	Agent Surface マニフェスト
l0g://mcp/server	アクティブな MCP サーバーのバージョン、SHA、トランスポート
l0g://openapi	OpenAPI の完全な仕様
l0g://freshness	コーパスの鮮度
l0g://integrity	正規 SHA-256 フィンガープリント
l0g://changes/latest	最新の公開とリビジョン
l0g://risk-diff	1日、7日、30日間のリスク差分
l0g://black-box	ハッシュ化されたポイントインタイムのリスクフレーム
l0g://signals/current	シグナルの現在の状態
l0g://signals/history	ポイントインタイムの観測値としきい値アラート

リソーステンプレート

Template	内容
l0g://articles/{slug}	メタデータ、参照、本文を含む記事の最初のページ
l0g://articles/{slug}{?section,offset,limit}	記事の指定ページ（body、head、tail、sources）
l0g://articles/{slug}{?cursor}	nextCursor による記事の続き
l0g://en/articles/{slug}	フランス語の正規の証拠に紐づく、英語分析の最初のページ
l0g://en/articles/{slug}{?section,offset,limit}	英語分析の指定ページ
l0g://en/articles/{slug}{?cursor}	nextCursor による英語分析の続き
l0g://guides/{slug}	メタデータと本文を含むガイドの最初のページ
l0g://guides/{slug}{?section,offset,limit}	ガイドの指定ページ（body、head、tail、sources）
l0g://guides/{slug}{?cursor}	nextCursor によるガイドの続き
l0g://en/guides/{slug}	英語ガイドの最初のページ
l0g://en/guides/{slug}{?section,offset,limit}	英語ガイドの指定ページ
l0g://en/guides/{slug}{?cursor}	nextCursor による英語ガイドの続き
l0g://claims/{claim_id}	主張と情報源の関係
l0g://sources/{source_id}	引用された一次情報源またはホスト
l0g://signals/{instrument}/current	現在のシグナルと閾値突破の履歴
l0g://methodologies/{instrument}	方法論の概要

resources/list は、クライアントのコンテキストにカタログ全体が注入されないよう、10 個の静的リソースに意図的に制限されています。記事、ガイド、主張、情報源、シグナル、方法論はテンプレート経由で URI から引き続き読み取れます。resources/templates/list でテンプレートを確認でき、主要な変数では補完コールバックも引き続き利用できます。検索・フィルタリングツールで対象を絞って情報を確認できます。このサービスはリクエスト／レスポンス形式でステートレスに動作し、resources.subscribe も resources.listChanged も通知しません。コーパスを監視するには、l0g://changes/latest を読み取るか、get_changefeed を呼び出してください。

公開されるプロンプト

MCP プロンプトは、ユーザーが明示的に選択するワークフローです。サーバーは listChanged を伴わずに prompts ケイパビリティを通知し、メッセージを返す前に各引数を検証します。定義の唯一のソースは src/lib/agent-prompts.mjs で、/agents/ ページでも使用されています。

Prompt	Arguments	Workflow
audit_financial_narrative	topic、language?	金融関連の物語を監査し、主張、証拠、推論、シナリオ、限界を切り分ける
explain_risk_change	window?、language?	1 日、7 日、30 日間で公開された Risk Diff を、外挿せずに説明する
verify_claim	claim、language?	正規の主張、その証拠、情報源と照合して主張を検証する
replay_as_of	date、question?、language?	指定日に実際にアーカイブされた Black Box フレームのみを再生する

公開されるツール

すべてのツールは、次の内容を返します。

• 人が読める短い要約を content に含める。
• 利用可能なデータを structuredContent に含める。
• SDK によって宣言・検証される outputSchema を含める。
• title と、readOnlyHint: true、destructiveHint: false、 idempotentHint: true、openWorldHint: false のヒントを含める。
• 応答でドキュメント、主張、情報源を参照する場合は、ネイティブの resource_link を含める。

そのため、JSON が再解析を要するテキストブロックに隠されることはありません。

コンパクトなファサード

Tool	役割
discover_l0g	機能、バージョン、鮮度、ルール、契約
search_l0g	コーパス全体を対象とする、フィルター付きのバイリンガル検索
get_document	参照情報付きのページ分割された記事またはガイド
get_evidence	主張、情報源、証拠のサブグラフ
build_research_pack	引用にそのまま使える、決定論的な調査パッケージ
get_risk_state	現在の状態、差分、履歴、またはリプレイ

全サーフェス

ツール	引数	返却内容
get_agent_manifest	なし	機能、エンドポイント、使用ルール、証拠に関するポリシー
get_risk_indices	なし	リスク指標（US、EU、Yen、Energie、Dette US）＋コンフルエンスの概要
get_signal_history	key?, limit?	日付付きの観測データ、引用可能な識別情報、方法論のバージョン、閾値の突破＋現在の状態
get_risk_diff	window?	1、7、30日間のRisk Diff：シグナル、ソース、主張、モデル、記事、信頼度
get_black_box	date?, limitFrames?	ハッシュ化されたリスクフレームのポイントインタイムリプレイ。リプレイできない日付は拒否されます
get_openapi_schema	mode?, path?	エンドポイントを指定した、または完全な要約版OpenAPI契約
get_ndjson_feed	feed, recordType?, limit?	許可リストに登録されたNDJSONフィード：カタログ、主張、エビデンスグラフ、変更、signalHistory
get_freshness	limit?	最新のコンテンツ、件数、シグナルごとの時間情報、鮮度ポリシー
search_content	query, language?, mode?, limit?	Agent SurfaceおよびWebMCPと共有する正規インデックスでのバイリンガル検索
build_research_pack	query, language, asOf?, riskWindow?, limit?	決定論的なエビデンスパック：ドキュメント、正規の主張、ソース、グラフ、鮮度、Risk Diff、反証材料、制約、引用可能なURL
get_claims	claimId?, articleSlug?, language?, sourceId?, kind?, query?, includeEvidence?, limit?	1つの契約で、検索、特定の主張、記事／ソースによる絞り込み、エビデンスの近傍情報を提供
get_evidence_graph	articleSlug?, language?, nodeType?, limit?	正規サブグラフ。英語のslugは重複なしでフランス語のグラフを参照します
list_sources	sourceId?, mode?, includeClaims?, limit?	一覧または特定のソース。要求に応じて関連する主張を含めます
get_integrity	path?	Agent Surfaceの正規SHA-256ハッシュ
verify_artifact	path, sha256?	整合性マニフェストを使った、許可リストに登録されたアーティファクトの検証
get_changefeed	contentType?, limit?	objectId、現在のバージョン／ハッシュ、差分のステータスを含む最新の変更
get_changes	contentType?, slug?, since?, limit?	バージョンメタデータで絞り込み可能な変更フィード
list_recent_analyses	language?, limit?	最新の分析。frまたはenで絞り込み可能
list_guides	language?	フランス語または英語のリファレンスガイド
search_by_topic	topic, language?, limit?	言語で絞り込み可能な、トピックに関する分析
get_article	slug, language?, offset?, cursor?, limit?, length?, section?	正規の参照情報を分離した、フランス語または英語のページ分割されたテキスト

l0g エージェントベンチ

公開済みのワークフローは、プロトコルテスト後にこのサーバーに対して agent-bench.mjs を実行します。44 件の FR/EN ケースは LLM を呼び出さず、ドキュメント上位 3 件、一次情報源、翻訳のパリティ、asOf、証拠のない場合の拒否、鮮度、クレームの型付けを網羅します。バージョン管理され、証明済みの結果は /api/v1/agent-bench.json で公開され、/agent-bench/ に表示されます。

長いドキュメントでは section、offset、limit、nextOffset、nextCursor が公開されます。例： l0g://articles/economie-des-intentions?section=sources&offset=0&limit=12000。 構造化された参照情報も references に個別に返されるため、 現在のテキストチャンクに依存しません。

get_risk_diff は、「昨日、7 日前、または 30 日前からリスクがどう変化したか」という種類の質問に答えるための近道です。get_black_box はリプレイに使用します。date を指定すると、ツールは指定日以前、または指定日に公開された最新のフレームを選択します。該当するフレームがない場合は、後から再計算するのではなく、その日付をリプレイ不可として応答に示します。

get_claims は、記事別、ソース別、証拠別の従来の個別パスをまとめたものです。不明な識別子には isError: true が付与されます。 存在しないリソースは、error フィールドを含む JSON ドキュメントではなく、MCP プロトコルエラーを返します。

セキュリティ

• 127.0.0.1 のみで待ち受けます。TLS と外部公開は Apache が管理します。
• すべてのリクエストで Host と Origin を検証します（DNS リバインディング対策。仕様で必須）。
• コーパスは読み取り専用です。編集データは変更されず、スラッグは 許可リストに含まれるものに限られます（パストラバーサルは拒否されます）。また、リクエスト本文のサイズは 1 MB に制限されています。
• テレメトリーは最小限です。systemd の StateDirectory に 91 日分の集計データのみを保存し、 IP、Cookie、セッション、フィンガープリント、ユーザーエージェントは記録しません。初期化が 5 回未満のクライアントファミリーは公開レポートで非表示になります。
• IP ごとにレート制限を設けています（デフォルトは 120 req/min。Apache が設定する X-Forwarded-For を使用）。
• Apache リバースプロキシ：LimitRequestBody を 1 MB に設定し、レスポンスにセキュリティヘッダーを付与し、アプリケーションのタイムアウトを 30 秒に設定し、エンドポイントではプロキシの keepalive を無効にします。
• systemd を強化しています：DynamicUser、TimeoutStartSec=45、TimeoutStopSec=15、UMask=0077、 PrivateIPC、LimitCORE=0、ProtectSystem=strict、ケイパビリティの消去、ReadOnlyPaths、 MemoryMax、システムコールフィルター。

アトミックデプロイ（Debian、サーバー「zen」）

前提条件：Apache がすでに l0g.fr を HTTPS で配信しており、サイトが /var/www/html/l0g/current にデプロイされていること。Node 22 以降が必要です。

1. MCP サービス用に Node 24 LTS をインストールする

sudo deploy/install-node24-runtime.sh

このスクリプトは、公式の Node.js 24.18.1 バイナリを /opt にインストールし、固定された SHA-256 を検証します。Debian パッケージは置き換えず、systemd のドロップインを介して MCP サービスのみを切り替えます。稼働中のデーモンの ID を維持し、ヘルスチェックに失敗した場合は以前の設定に戻します。

2. 証明済みリリースのポーラーを一度インストールする

完全なランブック、バックアップを含む移行ブロック、リリース手順は docs/MCP-RELEASE.md にあります。 この移行後、サーバーは git pull も npm ci も実行しません。公開されている GitHub Releases をポーリングし、SHA-256 と GitHub/Sigstore の証明を検証して候補をテストした後、シンボリックリンクをアトミックに切り替え、自動ロールバックします。

追加の前提条件：GitHub CLI で gh attestation verify が利用できる必要があります。タイマーと デーモンはデプロイ用の受信ポートを開かず、永続的な GitHub トークンも使用しません。

3. ローカルソースのドライランテスト

L0G_DATA_DIR=/var/www/html/l0g/current \
MCP_USAGE_PATH=/tmp/l0g-mcp-usage-test.json node server.mjs &
curl -s http://127.0.0.1:8848/healthz       # -> versions MCP/Agent Surface, SHA et fraîcheur chargée
node test-client.mjs                          # liste les tools et teste chaque appel
# le script force l'en-tête Accept requis par le Streamable HTTP :
# application/json, text/event-stream
kill %1

4. サービスとタイマーを確認する

systemctl status l0g-mcp l0g-mcp-deploy.timer --no-pager
journalctl -u l0g-mcp-deploy.service -n 100 --no-pager
curl -s http://127.0.0.1:8848/healthz        # -> versions MCP/Agent Surface, SHA et fraîcheur chargée

5. Apache リバースプロキシの設定

sudo a2enmod proxy proxy_http headers

リポジトリで管理されている vhost 全体は ../deploy/l0g.fr.apache.conf です。 本番環境では、アクティブなファイルをバックアップした後、 /etc/apache2/sites-available/l0g.fr-hardened.conf にトランザクション方式で インストールする必要があります。deploy/apache-l0g-mcp.conf は2つの MCP ルート 専用の独立した参照用ファイルであり、本番用 vhost のソースではありません。続いて：

sudo apache2ctl configtest        # Syntax OK
sudo systemctl reload apache2

reload 後：

sudo apache2ctl -M | rg -e "proxy_module|proxy_http_module|headers_module|rewrite_module"
curl -s -I https://l0g.fr/api/mcp/compact | sed -n '1,20p'
curl -s -I https://l0g.fr/api/mcp | sed -n '1,20p'

6. 外部から確認する

推奨するコンパクトなフロントエンドで、JSON-RPC を直接使用する最小限の MCP サイクル：

curl -s -X POST https://l0g.fr/api/mcp/compact \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0.1"}}}'

curl -s -X POST https://l0g.fr/api/mcp/compact \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

curl -s -X POST https://l0g.fr/api/mcp/compact \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | head -c 400

または、互換性のあるクライアント（mcp-remote 経由の Claude Desktop、MCP インスペクターなど）を https://l0g.fr/api/mcp/compact に接続します。完全なサーフェスの 専用ツールを使う場合に限り、URL を https://l0g.fr/api/mcp に変更してください。

7日間の収集後、オペレーターは other に引き続き含まれている正規化済みラベルを 読み取れます。このパスは Apache によるプロキシの対象ではなく、ローカル以外からの リクエストを拒否します：

curl -fsS http://127.0.0.1:8848/_l0g/mcp-client-taxonomy

更新

• データ（新しい記事、手がかり）：自動です。サイトが再デプロイされ、新しいディレクトリへの アトミックな切り替えによって、サービスのキャッシュが直ちに無効化されます。
• サーバーコード：mcp-vX.Y.Z タグの後に自動で更新されます。ワークフローは SBOM 付きの バージョン管理されたアーカイブをビルドし、OIDC で証明して GitHub Release に公開し、 zen のアトミックなデプロイを待ってから、OIDC で MCP Registry にマニフェストを公開します。
• Registry：主に下流のアグリゲーター向けの、プレビュー段階の発見チャネルです。公開後に 検証されますが、実運用テストや導入戦略に取って代わるものではありません。

環境変数

変数	デフォルト	役割
MCP_HOST	127.0.0.1	リッスンするインターフェース
MCP_PORT	8848	ローカルポート
MCP_PATH	/mcp	エンドポイントのパス
MCP_USAGE_PATH	未設定	集計済みカウンターのプライベートファイル。本番環境では /var/lib/l0g-mcp/usage.json
L0G_DATA_DIR	/var/www/html/l0g/current	デプロイされたサイトのルート（読み取り専用）
L0G_SITE	https://l0g.fr	返される URL のベース
MCP_ALLOWED_HOSTS	l0g.fr,127.0.0.1,localhost	許可される Host ヘッダー
MCP_ALLOWED_ORIGINS	https://l0g.fr	許可される Origin ヘッダー
MCP_MAX_BODY_BYTES	1048576	リクエストごとのペイロード上限（1 MB）
MCP_RATE_MAX	120	IP あたりのリクエスト数／分
MCP_HEADER_TIMEOUT	10000	HTTP ヘッダーのタイムアウト（ms）
MCP_REQUEST_TIMEOUT	15000	HTTP リクエスト全体のタイムアウト（ms）
MCP_KEEP_ALIVE_TIMEOUT	5000	TCP keep-alive のタイムアウト（ms）
MCP_MAX_HEADERS_COUNT	64	解析可能なヘッダーの最大数
MCP_RELEASE_ATTESTED	未設定	poller が来歴を検証したアーカイブ内でのみ 1