ProvenPin

ウェブサイト · 無料モデル · 外部テスト · インストール · テスト結果フィード

ProvenPin

無料および低価格の AI モデルが動作するコードを書けるよう支援する、テスト済みでバージョンが固定された複数ライブラリ対応のコードレシピを、MCP 経由で提供します。

各レシピでは正確なバージョンを固定し、クリーンな環境で独自のテストを実行して、最後に合格した日時を記録したテスト結果を保持します。レシピで使用するライブラリが新しいリリースを公開すると、レシピは自動的に再テストされます。MCP サーバーは、現在テストに合格しているレシピのみを提供します。

インストール

ProvenPin はホスト型の MCP サーバーです。API キーも登録も不要です。

エンドポイント：https://mcp.provenpin.com/mcp

Claude Code

claude mcp add --transport http provenpin https://mcp.provenpin.com/mcp

現在のプロジェクトだけでなく、すべてのプロジェクトで読み込むには、--scope user を追加してください。

Cursor（~/.cursor/mcp.json）

{ "mcpServers": { "provenpin": { "url": "https://mcp.provenpin.com/mcp" } } }

Cursor のワンクリックインストールリンク（Cursor がインストールされているマシンで開いてください）：

cursor://anysphere.cursor-deeplink/mcp/install?name=provenpin&config=eyJ1cmwiOiJodHRwczovL21jcC5wcm92ZW5waW4uY29tL21jcCJ9

OpenCode（プロジェクトルートの opencode.json）

{ "$schema": "https://opencode.ai/config.json", "mcp": { "provenpin": { "type": "remote", "url": "https://mcp.provenpin.com/mcp", "enabled": true } } }

VS Code（.vscode/mcp.json）

{ "servers": { "provenpin": { "type": "http", "url": "https://mcp.provenpin.com/mcp" } } }

Windsurf（~/.codeium/windsurf/mcp_config.json）

{ "mcpServers": { "provenpin": { "serverUrl": "https://mcp.provenpin.com/mcp" } } }

Cline（MCP 設定）

{ "mcpServers": { "provenpin": { "type": "streamableHttp", "url": "https://mcp.provenpin.com/mcp" } } }

続いて、「Next.js の Stripe webhook 用のテスト済みレシピを探して」のようにエージェントに依頼してください。

MCP ツール

ツール	機能
search_recipes	通常の単語、スタックのフィルター、または言語で、テストに合格したレシピを検索します
get_recipe	ファイル一式、固定されたバージョン、セットアップおよびテストのコマンド、テスト結果を取得します
list_stacks	テスト済みレシピがあるライブラリを件数とともに一覧表示します

recipes/   one folder per recipe (see SPEC.md)
runner/    validate, run tests in isolation, write receipts, release check, build index
receipts/  real test receipts (JSON)
index/     built index.json served by the MCP server
server/    MCP server (TypeScript, Cloudflare Workers, local dev mode)
.github/   CI: matrix per recipe, scheduled + on demand, release-triggered re-tests

ローカルで実行する（Node 22 以降、Python 3.13、および Python レシピ用の uv）

npm install
npm run validate                 # check manifests and pins
npm run test:recipes             # run every recipe, write receipts
node runner/run.mjs hono-zod-validator   # run one
node runner/typecheck.mjs hono-zod-validator   # tsc --noEmit on a TypeScript recipe (CI runs it on touched recipes)
npm run affected                 # recipes with newer upstream releases
npm run build:index              # build index/index.json
npm test                         # runner unit tests

cd server && npm install
npm test                         # MCP server unit tests
npm run dev                      # http://localhost:8787/mcp

たとえば Claude Code で、クライアントをローカルサーバーに接続します。

claude mcp add --transport http provenpin http://localhost:8787/mcp

Pro API キー（準備中で、デフォルトでは無効）：無料プランではキーは不要です。PROVENPIN_PRO_ENABLED が "true" の場合、有効な Authorization: Bearer <key> ヘッダーがあると、呼び出し元は Pro として認識されます。キーは PROVENPIN_API_KEYS シークレット、または PRO_KEYS KV 名前空間（エントリは key:<sha256 of key>）から取得します。使用状況イベントに記録されるのはプラン（free または pro）のみで、キーは記録されません。

テスト結果フィード

https://mcp.provenpin.com/receipts.json（および index/receipts.json。インデックスとともに再構築）には、すべてのレシピが一覧表示されます。

フィールド	意味
id, language	レシピ ID と言語
pinned	レシピのテストに使用した正確なバージョン
runtime	最後のテスト実行時のランタイム。例：node v22.23.3
status	passed、failed、setup_failed、invalid、stale（最後の実行以降にコードが変更された状態）、または untested
last_passed_at	固定されたバージョンで最後にテストに合格した日時（UTC）
run_url	現在のテスト結果を生成した GitHub Actions の実行
staleness	スタック内のライブラリを最新バージョンに更新して毎週再テストした結果：status（current、passes_on_latest、breaks_on_latest、deprecated_upstream（スタック内のライブラリの安定版が npm ですべて非推奨になっている状態）、error、または unchecked）、checked_at、試した最新バージョン（latest）、run_url

陳腐化チェック（.github/workflows/staleness.yml）は、一時コピー上で毎週実行されます。レシピやそのテスト結果を編集することはなく、最新バージョンで動作しないレシピを 1 件の GitHub issue にまとめて掲載します。

独自にデプロイする

1. このリポジトリをブランド用の GitHub アカウントにプッシュします。
2. Cloudflare で「Edit Cloudflare Workers」権限を持つ API トークンを作成し、CLOUDFLARE_API_TOKEN と CLOUDFLARE_ACCOUNT_ID をリポジトリのシークレットに追加して、リポジトリ変数を DEPLOY_ENABLED=true に設定します。
3. cd server && npx wrangler deploy を実行する（または CI に任せる）か、mcp.<domain> をワーカーにルーティングします。

ライセンス

MIT。LICENSE を参照してください。