framework-mcp

framework-mcp

コーディングエージェント向けの依存関係の最新性確認レイヤーです。コーディングエージェント（Claude Code、Cursor など）に、変化の速いフレームワーク（Expo、Next.js、Supabase、Prisma など）の検証済みかつバージョン固定の回答を提供するリモート MCP サーバーです。

理由：LLM の学習データは、フレームワークのリリースサイクルよりも速く古くなります。エージェントは、検証済みでバージョン固定された情報源を確認する代わりに、バージョン固有の同じ質問について何度も推測しています。このサーバーは、その情報源です。単一のフレームワーク向けツールではなく、依存関係の現在の挙動について「記憶」している内容を信頼する前に、あらゆるコーディングエージェントが問い合わせられる汎用レイヤーです。

スタック

Node 24 + TypeScript、Streamable HTTP トランスポート（ステートフル、接続ごとにセッションを作成）での @modelcontextprotocol/sdk、Express、Postgres（pg）、SDK 独自の requireBearerAuth ミドルウェアによる API キー認証。

ホスティング：Railway（コンピューティング、Hobby プランで約 5 ドル／月）+ Neon（Postgres、無料プラン、ブランチ作成可能）。

ローカルでのセットアップ

1. 無料の Neon アカウントとプロジェクトを作成します。dev ブランチの接続文字列をコピーします。
2. cp .env.example .env を実行し、DATABASE_URL（Neon から取得）と API_KEY_PEPPER（長いランダム文字列。node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" で生成できます）を設定します。
3. インストール、マイグレーション、シード、ビルドを実行します。

   npm install
   npm run db:migrate
   npm run db:seed
   npm run build
   

4. 自分用の API キーを作成します。

   npm run create-api-key -- "my laptop"
   

   ここで生のキーが表示されるのは一度だけです。再取得できないため、保存してください。
5. ローカルで実行します。

   npm run dev
   

   curl http://localhost:3000/health が ok を返すことを確認します。

MCP Inspector で検証する

npx @modelcontextprotocol/inspector

トランスポートに「Streamable HTTP」を指定して http://localhost:3000/mcp に接続し、接続設定で Authorization: Bearer <your-api-key> ヘッダーを設定します。3 つのツール（ping、query_framework_doc、report_outcome）が一覧に表示され、呼び出せることを確認します。

Railway にデプロイする

1. curl -fsSL agents.railway.com | sh を実行してから、railway login を実行します。
2. このリポジトリから railway init を実行します（既存のプロジェクトがある場合は railway link を実行します）。
3. 環境変数を設定します（ダッシュボード、または railway variable set KEY=value を使用）：DATABASE_URL（Neon の本番ブランチ接続文字列。開発ブランチとは別のもの）、API_KEY_PEPPER、NODE_ENV=production。
4. railway up を実行します。
5. Railway ダッシュボードで、Settings → Networking → Generate Domain の順に選択します。PUBLIC_HOSTNAME をそのドメインに設定します（実際のトラフィックを許可するには、SDK の DNS リバインディング対策のホストチェックに必要です）。
6. 本番用の DATABASE_URL に対して、npm run db:migrate && npm run db:seed を一度実行します（本番の接続文字列を指定して、自分のマシンから実行します）。
7. 本番用の DATABASE_URL を指定して npm run create-api-key を実行し、本番用の API キーを作成します。

API キーを取得する

セルフサービス：https://framework-mcp-production.up.railway.app/ にアクセスし、メールアドレスを入力すると、すぐにキーを取得できます（メールアドレスごとに有効なキーは 1 つで、レート制限があります）。

メンテナー／ローカル環境での代替手段：npm run create-api-key -- "label"。

リモートクライアントを接続する

Claude Code の .mcp.json では、以下のように設定します。

{
  "mcpServers": {
    "framework-mcp": {
      "type": "http",
      "url": "https://<your-railway-domain>/mcp",
      "headers": { "Authorization": "Bearer <your-api-key>" }
    }
  }
}

ツール

• ping(message) - ヘルスチェック
• list_frameworks() - 対象となるすべてのフレームワーク／バージョンを、エントリー数とともに一覧表示します。下記に渡す正確なスラッグ／バージョンがわからない場合は、まずこれを呼び出してください
• query_framework_doc(framework, version, question) - 検証済みの回答を検索し、query_id を返します
• report_outcome(query_id, worked, note?) - 返された回答が実際に役立ったかどうかを記録します

対応範囲

フレームワーク	バージョン	項目数	ソース
Expo SDK	54.0.0	20	expo.dev/changelog/sdk-54
Next.js	16.3.2	20	nextjs.org/blog, nextjs.org/docs upgrade guide
Supabase (supabase-js)	2.112.3	20	supabase.com/changelog, GitHub releases
Prisma ORM	7.9.1	20	prisma.io/docs upgrade guide, prisma.io/changelog
Vercel AI SDK	7.0.77	20	ai-sdk.dev migration guides, vercel.com/blog
Nuxt	4.5.2	20	nuxt.com/docs upgrade guide, nuxt.com/blog

各シードファイル（db/seed/ 内）に記載された公式ソースに基づき、すべての項目を 2026-08-22 に検証済みです。フレームワークを追加するには、既存ファイルの形式に従って新しい db/seed/<slug>.json を作成し、npm run db:seed を実行します（このコマンドはフォルダー内のすべての *.json を自動的に読み込みます）。

ステータス

セルフサービス登録を / で提供中です（メールアドレスを入力すると、API キーが即時発行されます。メールアドレスごとに 1 つで、IP によるレート制限があります）。公式 MCP Registry（registry.modelcontextprotocol.io）に公開済みで、mcpservers.org と Glama にも申請済みです（どちらも審査待ち）。Smithery には登録していません（OAuth 検出スキャナーが、静的なベアラーキーによるシンプルな認証に対応していないため）。mcp.so にも登録していません（無料掲載プランがないため）。

保留中（ステージ B、未実装）：Stripe による課金、api_keys の plan_tier／credit_balance／キー単位のレート制限適用、フィードバックのスコアリング／ランキング。