ProvenPin

网站 · 免费模型 · 外部测试 · 安装 · 测试记录动态

ProvenPin

经过测试、固定版本的多库代码配方，通过 MCP 提供，旨在帮助免费和低价 AI 模型编写可运行的代码。

每个配方都固定了确切版本，会在干净的环境中运行自身测试，并附带一份记录，注明最近一次通过测试的时间。配方所用的任何库发布新版本时，系统都会自动重新测试。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" } } }

然后向你的 Agent 提出类似“查找一个经过测试的 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）每周都会在临时副本中运行。它绝不会修改配方或其测试记录，并会在一个 GitHub 问题中列出在最新版本上无法正常运行的配方。

部署自己的实例

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> 路由到该 Worker。

许可证

MIT。请参阅 LICENSE。