framework-mcp

コーディングエージェント向けの依存関係の最新性チェックレイヤー: 急速に進化するフレームワーク（Expo、Next.js、Supabase、Prisma、および増加中）について、検証済みでバージョン固定された回答をコーディングエージェント（Claude Code、Cursorなど）に提供するリモートMCPサーバーです。

理由: LLMの学習データはフレームワークのリリースサイクルよりも早く陳腐化します。エージェントは、検証済みでバージョン固定されたソースを確認する代わりに、同じバージョン固有の質問を繰り返し推測し続けます。このサーバーはそのソースです。単一フレームワーク用のツールではなく、依存関係の現在の動作について「記憶」を信頼する前に、あらゆるコーディングエージェントが照会できる汎用レイヤーです。

スタック

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

ホスティング: Railway（コンピュート、~$5/月のHobbyプラン）+ Neon（Postgres、無料ティア、ブランチ可能）。

Related MCP server: react-native-dev-mcp

ローカルセットアップ

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の本番ブランチの接続文字列。devブランチとは別）、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() - カバーされているすべてのフレームワーク/バージョンをエントリ数付きで一覧表示 - 以下に渡す正確なslug/バージョンがわからない場合は、これを最初に呼び出してください

• query_framework_doc(framework, version, question) - 検証済みの回答を検索し、query_idを返します

• report_outcome(query_id, worked, note?) - 返された回答が実際に機能したかどうかを記録します

カバレッジ

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

ステータス

セルフサービス登録は/で公開中です（メール→即時APIキー、メールごとに1つ、IPレート制限あり）。公式MCPレジストリ（registry.modelcontextprotocol.io）に公開済みで、mcpservers.orgとGlamaに提出済みです（どちらもレビュー待ち）。Smithery（OAuthディスカバリースキャナーが単純な静的ベアラーキー認証に対応していない）やmcp.so（無料の掲載ティアがない）には未掲載です。

延期（ステージB、未構築）: Stripe請求、plan_tier / credit_balance / api_keysに対するキーごとのレート制限適用、フィードバックのスコアリング/ランキング。