ツール

Front-End Checklist が MCP Server 化した話——老舗品質リストを AI Agent のそばへ

GitHub で 21 万 Stars を集める老舗プロジェクト Front-End Checklist が MCP Server として再構成され、AI Agent から直接同じルールを呼び出せるようになった。

文字サイズ

Front-End Checklist は GitHub 上で長らく使われてきた老舗のフロントエンドプロジェクトで、オープンソースのコードレビュー用チェックリストとして知られている。最近の大規模なリファクタリングで MCP Server 化され、同じルール群を AI Agent から直接呼び出せる構造化エンドポイントとして提供されるようになった。

この動きは注目に値する。従来、a11y・パフォーマンス・SEO・セキュリティ・i18n・プライバシーといった観点を揃えるには、Lighthouse、axe-core、ESLint、Stylelint をそれぞれ組み合わせるためのグルーコードを自分で書く必要があった。AI Agent の時代に入って、Cursor や Claude Code といったツールはコードを読めるが、構造化されたチェックリストにはアクセスできない。「best practices をチェックして」と頼めば「alt 属性をつけましょう」くらいの答えしか返ってこず、「<label> に for 属性がない」レベルの指摘は出てこない。

以下に背景、使い方、そして今回の MCP 化の内訳をまとめる。

概要

オープンソースのフロントエンドコードレビューチェックリスト。a11y、パフォーマンス、SEO、セキュリティ、画像、プライバシーなどをカバーし、各ルールに優先度・説明・修正方法を備えている。

従来は以下の3つの入り口が用意されていた。

  • ウェブサイト:サイトを開いて項目ごとに確認
  • GitHub README:リポジトリの README 上で checkbox リストを走査
  • パッケージ / CLI:npm パッケージまたはコマンドライン経由で利用

今回のリファクタリング内容

作者はルール定義を MCP Server として切り出した。MDX を Single Source of Truth とし、pnpm スクリプトでマルチターゲット向けのビルド物を生成する構成になっている。

  • 静的サイト
  • README 用 checkbox リスト
  • MCP Server の tool schema(新規)

Agent に渡されるのは単なる markdown テキストではなく、構造化されたフィールド付きのルールオブジェクトだ。優先度によるフィルタ、ルール ID による参照、エディタへの inline hint のフックも可能になっている。

使い方

MCP 接続の設定(Claude Desktop / Cursor 互換):

{
  "mcpServers": {
    "front-end-checklist": {
      "url": "https://mcp.frontendchecklist.io",
      "transport": "streamable-http"
    }
  }
}

設定後、Agent に list_rules を呼ばせて分類を取得し、優先度でフィルタしたうえで、ルール ID 付きの修正提案を生成させる。

強み

  • 単一ツールより広いカバレッジ。a11y、パフォーマンス、SEO、セキュリティ、i18n、プライバシーを1つの表にまとめている
  • ルールに修正アクションが付属。「チェックするだけ」ではなく、修正コード例と検証方法が各ルールに付いている
  • MCP 化で同類プロジェクトに先回り。ルールを agent-consumable な形で提供しているのは他より早い

弱み

  • 静的ルールのためプロジェクト文脈を読めない。Next.js 13 なのか、5 年ものの技術負債を抱えた React アプリなのかまでは把握しない
  • HTML 中心の従来型プロジェクト寄り。純粋な SPA やモダンなビルド構成への適合は限定的
  • 全量を Agent に渡すとトークン消費が大きい。Agent 側で優先度を選び取る必要があり、user prompt で「critical and high-priority first」と明示する必要がある
  • カスタムルールの重み付けには対応していない

向き不向き

向いているケース:

  • チーム内の review 基準を統一したいフロントエンドチーム(社内 checklist ドキュメントを書く必要がなくなる)
  • 新入社員や外注先に渡すオンボーディング資料として
  • AI 補助の code review で、構造化されたルールソースを接続したい場合

向いていないケース:

  • Lighthouse だけで十分な小規模プロジェクト
  • 純粋なバックエンド / モバイル案件

まとめ

Front-End Checklist のアプローチは参考になる。「人間の知識」と「Agent が消費できる形式」を Single Source of Truth にまとめるという設計思想だ。MDX を SSOT に置き、pnpm スクリプトでマルチターゲット向けのビルド物を生成するという構成は、かなりエンジニアリング寄りの解法といえる。

すでに Claude Code や Cursor を review に使っているチームなら、この MCP server を PR ワークフローに組み込んでみる余地がある。人手での review を置き換えるものではなく、量が多いルールの一次チェックは Agent に任せ、判断が求められる部分に人の工数を集中させる形だ。

参考:Front-End Checklist GitHub

出典: https://github.com/thedaviddias/Front-End-Checklist