自作MCPサーバーに「読み取り専用モード」を実装する — AIに何をさせないかを設計する

Claude CodeからPDF一括変換のMCPツールを呼び出した際、60秒でtimed outし、AIの再試行でサーバー側の処理が二重に走ってファイルが破損した事例の解説。原因はタイムアウトが処理を止めない同期構造にあり、job_idを即時返却してget_job_statusでポーリングし、同一targetの実行中ジョブを再利用して冪等性を確保するFastMCPの完全実装を掲載。長時間処理のMCPサーバーを自作する開発者向け。

TERASSが住宅購入相談向けAIエージェントの判断ロジックを「住宅購入AIフレームワーク」としてGitHubで公開。12分野の原則、約190項目の数値前提、テストケース、CI、評価ハーネスを備えたリポジトリとして管理し、配信用URLやMCPサーバー経由でClaude Codeにも導入可能。業務判断をAIに教えたい開発者向けの設計事例。

Claude Code / Cursor / Codex 等のコーディング Agent 向け設計パターン21件を、隔離サンドボックスで A/B 比較した随時更新型のベンチマーク集。上位は MEMORY.md による罠メモ継承、Tree-sitter による骨格のみの注入、テスト出力の JSON 圧縮で、入力トークン削減率はいずれも約94〜95%。役割別サブエージェントによる手戻り増加、同一コンテキストでの自己テストでミュータント撃破率0%といった逆効果の知見も収録。

歌詞MVツール MeltLyric で、プレビューと MP4 書き出しの一致を保証する設計の解説。描画を時刻 t のみに依存する render(t) に一本化し、音声特徴量は事前解析で配列化。Agent が MCP の `write_part` で書くコード部品は Web Worker 内で `Math.random` や `Date`、`fetch` 等を遮断して隔離実行する構成。AI生成コードの決定論と安全性を担保したい開発者向け。