Генерирует отчеты о приемке в режиме только для чтения для Git-изменений, чтобы проверить, что именно было изменено и какие проверки выполнял AI agent.
Также известен как 2648782102/proofpack-cli, proofpack-cli
- Звёзды
- 1
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 0.3.2
- Последний коммит
- 9 нояб. 2026 г.
- Лицензия
- MIT
Что такое Proofpack MCP?
Генерирует отчеты о приемке в режиме только для чтения для Git-изменений, чтобы проверить, что именно было изменено и какие проверки выполнял AI agent.
Сводка сгенерирована из README проекта
О Proofpack MCP server
Proofpack предоставляет разработчикам подтверждение (evidence receipt) внесенных AI agent изменений в коде. Он генерирует отчеты о приемке в режиме только для чтения, в которых подробно описывается то, что видит Git, какие именно проверки были выполнены и какие задачи остались непроверенными. Этот инструмент помогает понять, что именно было изменено и какое тестирование действительно проводилось после завершения задачи по написанию кода.
Сервер работает локально как запущенный хостом подпроцесс через stdio entrypoint proofpack-mcp и не требует аккаунтов, облачных сервисов или API моделей. При использовании через MCP host он предоставляет одну функцию proofpack_check, которая выполняет чтение данных Git для создания отчетов в форматах Markdown или JSON, не выполняя команды проекта и не записывая файлы. Для пользователей, запускающих CLI напрямую, инструмент может выполнять определенные команды с помощью флага --run, используя локальную оболочку и привилегии пользователя.
В отличие от автоматизированных тестеров, Proofpack не утверждает, что изменение является корректным или безопасным для слияния. Он фокусируется на разграничении наблюдаемых фактов, эвристических подсказок и непроверенной работы, гарантируя, что разработчики знают границы проведенной верификации.
Что вы можете с ним делать
- 1Проверка изменений кода AIГенерируйте отчет, чтобы увидеть, какие файлы были изменены и как выглядит сводка diff после завершения задачи агентом.
- 2Документирование выполненных команд тестированияЗапускайте конкретные наборы тестов и фиксируйте их статус выхода и время выполнения в официальном отчете о приемке.
- 3Поиск непроверенных участков кодаОпределяйте, какие этапы процесса разработки, такие как линтинг или аудит зависимостей, были пропущены во время сессии.
- 4Обмен очищенными результатами верификацииСоздавайте безопасную версию отчета, удаляя конфиденциальные пути и текст команд перед тем, как поделиться им с другими.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Proofpack MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Proofpack MCP в Claude Code
$ claude mcp add proofpack-cli -- npx -y proofpack-cliУстановка Proofpack MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"proofpack-cli": {
"command": "npx",
"args": [
"-y",
"proofpack-cli"
]
}
}
}Установка Proofpack MCP в VS Code
.vscode/mcp.json
{
"servers": {
"proofpack-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"proofpack-cli"
]
}
}
}Установка Proofpack MCP в VS Code CLI
$ code --add-mcp '{"name":"proofpack-cli","type":"stdio","command":"npx","args":["-y","proofpack-cli"]}'Установка Proofpack MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"proofpack-cli": {
"command": "npx",
"args": [
"-y",
"proofpack-cli"
]
}
}
}Установка Proofpack MCP в Codex
$ codex mcp add proofpack-cli -- npx -y proofpack-cliУстановка Proofpack MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.proofpack-cli] command = "npx" args = ["-y", "proofpack-cli"]
Установка Proofpack MCP в Gemini CLI
$ gemini mcp add -s user proofpack-cli npx -- -y proofpack-cliУстановка Proofpack MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"proofpack-cli": {
"command": "npx",
"args": [
"-y",
"proofpack-cli"
]
}
}
}Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторий2648782102/proofpack-cli is public and reachablegithub.com/2648782102/proofpack-cli ↗Пройдено
- Пакет указывает этот репозиторий как источникproofpack-cli names 2648782102/proofpack-cli as sourcenpmjs.com/package/proofpack-cli ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-09github.com/2648782102/proofpack-cli ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from proofpack-cliПройдено
- Нет критических предупреждений в пакете или его зависимостях1 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubProofpack
An evidence receipt for AI-assisted code changes.
After a coding agent says "done", Proofpack shows what Git can see, which checks actually ran, and what remains unchecked. It runs locally, needs no account, and never gives a "safe to merge" verdict.
npx -y --package=proofpack-cli@0.3.2 proofpack check --run "npm test"
The command prints a Markdown report to stdout. Default inspection is read-only; npm test runs only because it was explicitly supplied with --run.
## Change
- Git-visible files: 2
- Diff summary: 18 insertions · 2 deletions
## Checks
- Explicit commands requested: 1
- Observed outcomes: 1 passed · 0 failed · 0 not run
- npm test: passed · exit 0
## Not checked
- Lint, build, dependency audits, and runtime behavior were not run.
Repository: 2648782102/proofpack-cli · npm: proofpack-cli · Release: v0.3.2
What it is for
Proofpack helps an individual developer answer three questions after a coding task: what changed, what checks actually ran, and what remains unchecked. It records Git change facts, explicit command evidence, and heuristic review prompts; it does not claim that a change is correct.
The report separates observed facts, heuristic prompts, and unchecked work. A passing command is evidence of that invocation only.
Product principles
- One command, one readable report.
- Local by default; no account, daemon, model API, or upload.
- Observed facts, heuristic prompts, and unchecked work are separated.
- No project command runs unless the user explicitly supplies
--run. - Git inspection is read-only; explicitly run commands use the user's shell and privileges without a sandbox.
Current distribution shapes
The 0.3.2 package contains both the proofpack CLI and the proofpack-mcp stdio entrypoint. MCP is a host-launched local subprocess, not a cloud service or a host plugin. See docs/MCP.md for the protocol contract and host configuration.
MCP quick start
After installing the package in a project, configure an MCP host to launch the local binary:
{
"mcpServers": {
"proofpack": {
"command": "npx",
"args": ["-y", "--package=proofpack-cli@0.3.2", "proofpack-mcp"]
}
}
}
The host then sees one read-only proofpack_check tool. It generates a Markdown or JSON acceptance report without executing project commands or writing files.
Install and first use
Use npm without a global install:
npx -y --package=proofpack-cli@0.3.2 proofpack check
Or install the package in a project:
npm install --save-dev proofpack-cli@0.3.2
npx proofpack check
The CLI binary is named proofpack; the MCP binary is named proofpack-mcp.
This prints a Markdown report to stdout without changing the working tree, running project commands, or making network requests. To save it, pass an explicit path:
npx -y --package=proofpack-cli@0.3.2 proofpack check --output .proofpack/review.md
Explicit checks
npx -y --package=proofpack-cli@0.3.2 proofpack check --run "npm test" --run "npm run lint"
npx -y --package=proofpack-cli@0.3.2 proofpack check --run "npm test" --format json
npx -y --package=proofpack-cli@0.3.2 proofpack check --run "npm test" --format markdown,json --output .proofpack/review.md
Each command is previewed before execution, run sequentially from the repository root through the user's shell, and recorded with timing, exit status, bounded stdout/stderr, truncation, and best-effort redaction. --timeout <seconds> defaults to 120 and applies per command. Multiple formats require --output and write sibling .md / .json files.
Commands are not sandboxed and can modify the working tree. Review every command and its output before sharing a report. Passing checks are evidence of those invocations only, not proof of correctness or security.
Branch/base and sharing
npx -y --package=proofpack-cli@0.3.2 proofpack check --base main
npx -y --package=proofpack-cli@0.3.2 proofpack check --run "npm test" --share-safe --output .proofpack/share.md
npx -y --package=proofpack-cli@0.3.2 proofpack check --output .proofpack/review.md --open
To render the report in Simplified Chinese, pass --lang zh-CN or set PROOFPACK_LANG=zh-CN. The default is English. This changes Markdown and JSON text fields only; schema keys, status values, paths, command stdout, and rule IDs stay unchanged.
npx -y --package=proofpack-cli@0.3.2 proofpack check --lang zh-CN
--base compares committed, staged, and working-tree changes against a resolved Git ref and excludes untracked files from that view. --share-safe omits branch, HEAD, base commit, file paths, output destination, command text, command output, and prompt evidence from both Markdown and JSON; status, counts, timings, and limitations remain. --open is opt-in, requires a written Markdown report, and uses the system opener. It never uploads the report.
Review even share-safe reports before sharing: omission is best-effort and aggregate metadata may still be sensitive.
What it does not do
Proofpack does not discover or run package scripts automatically, infer test or build results, review code with an AI, assign a correctness score, approve changes, upload reports, collect telemetry, or sandbox explicit --run commands. Commands supplied with --run use the current user's shell and privileges.
The MCP adapter is narrower still: its single proofpack_check tool performs read-only Git inspection and does not execute project commands, write report files, open applications, make network requests, or invoke a model.
Early development: repository-local init, sandboxed execution, CI-result import, and agent-trace import are not implemented. See roadmap and MCP contract.
Development
Requirements: Node.js 24 or newer.
npm install
npm run dev -- check
npm run check
npm test
npm run build
Documents
- Product requirements
- User experience
- CLI contract
- MCP contract
- Architecture
- Security and privacy
- Open-source references
- Roadmap
- Development handoff
- Release checklist
- 0.3.1 release notes
- 0.3.2 release notes
- Distribution and promotion
- 30-second demo script
- Changelog
- Decisions
License
MIT. See LICENSE.
Вопросы о Proofpack MCP
Как добавить Proofpack MCP в Claude Code?
Выполните claude mcp add proofpack-cli -- npx -y proofpack-cli в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Proofpack MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Выполняет ли Proofpack команды проекта через MCP?
Нет, MCP adapter ограничен только чтением данных Git и не выполняет команды проекта, не записывает файлы и не делает сетевых запросов.
Является ли Proofpack облачным сервисом?
Нет, это локальный инструмент, который запускается как подпроцесс хоста и не требует аккаунтов или облачного подключения.
Гарантирует ли Proofpack корректность изменений кода?
Нет, он лишь предоставляет доказательства того, что изменилось и какие команды были запущены; он не гарантирует корректность и не выносит вердикт о безопасности слияния.
Могу ли я запускать определенные тесты с помощью Proofpack?
Да, вы можете использовать флаг --run, чтобы явно указать команды, например npm test, для их последующей записи в отчет.