CLI ツールを MCP サーバーに作り替える──単純なツール移植では済まなかった設計転換

PDF 仕様書参照・ファイル読み込み・署名検証・監査手順の 4 つの MCP サーバーと Skill を体系化した「PDF Agent Stack」。個別ツール群ではなく、LLM が PDF について決定論的に「言い切る」ための知識インフラとして設計。宣言・適合・検証の区別を道具に焼き込み、AI エージェントが推論の揺れなく正確な判定に至るアーキテクチャを解説。

AIエージェント向けナレッジに人間の承認フロー(draft → review → verified)を持ち込む OSS「Kahanyaku」をサーバーに置き、Codex と Claude から HTTP MCP経由で同じ承認済みナレッジにアクセスするアーキテクチャを解説。Caddy / Docker / SQLite を用いた最小構成で、HTTPS + Bearer token による認証制御を実装。

MCPが公開以来最大規模の仕様変更を受け、プロトコル全体が「ステートレス（状態を持たない仕組み）」に移行した。従来のセッションID管理による複雑な問題（ロードバランサーでのエラー、サーバー再起動時の即死）が解決され、標準的なHTTPインフラの上でシンプルかつ低コストに動作可能になった。

Telegram に投げた考え・写真・リンクを、Solar Pro4 が自動整理し毎晩拡張、Claude が金曜に振り返る知識管理システムの実装例。キャプチャは速く、整理と解釈は後で処理する役割分離により、毎日消えていた知識が蓄積される仕組みが実現。ニーチェの本の 1 ページが知識カード化される具体的なフローを解説。