framework-mcp

リモートMCPサーバー。コーディングエージェント（Claude Code、Cursorなど）に、急速に進化するフレームワークについて検証済み・バージョン固定の回答を提供します——まずはExpo SDK 54から対応しています。

理由：LLMの学習データはフレームワークのリリースサイクルより速く陳腐化します。エージェントは検証済み・バージョン固定のソースを確認せず、同じバージョン固有の質問を繰り返し推測し続けます。このサーバーがそのソースです。

スタック

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

ホスティング：Railway（コンピュート、約$5/月のHobbyプラン）+ 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の本番ブランチの接続文字列。devブランチとは別）、API_KEY_PEPPER、NODE_ENV=production。

4. railway upを実行します。

5. Railwayダッシュボードで：設定 → ネットワーク → ドメイン生成。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) - ヘルスチェック

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

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

ステータス

db/seed/expo-54.jsonのシードデータ（20件）は、2026-08-21にhttps://expo.dev/changelog/sdk-54とhttps://docs.expo.dev/modules/autolinking/に対して検証済み。

セルフサービスサインアップは/で公開中（メールアドレス → 即時APIキー、メールアドレスごとに1つ、IPレート制限付き）。Smithery / Glama / mcp.soに掲載。

延期（Stage B、未構築）：Stripe請求、api_keysのplan_tier / credit_balance / キーごとのレート制限適用、他のフレームワーク、フィードバックのスコアリング/ランキング。