proof-of-commitment
Proof of Commitment
별점은 거짓말을 합니다. 행동 신호는 그렇지 않습니다.
별점, README, 다운로드 수보다 위조하기 어려운 행동적 헌신(behavioral commitment) 신호를 기반으로 npm 패키지, PyPI 패키지 및 GitHub 저장소의 점수를 매기는 MCP 서버이자 웹 도구입니다.
공급망 문제
일반적인 Node.js 프로젝트에서 다음 세 가지 패키지는 현재 매우 중요(CRITICAL)합니다:
chalk — 주당 3억 9,900만 다운로드, 유지보수자 1명
zod — 주당 1억 3,900만 다운로드, 유지보수자 1명
axios — 주당 9,600만 다운로드, 유지보수자 1명 (2026년 4월 1일 공격 발생)
별점이나 README 품질로는 이런 위험을 파악할 수 없습니다. 행동 신호는 가능합니다.
Related MCP server: pkgtruth
지금 바로 사용해 보기
터미널 (설치 불필요):
npx proof-of-commitment axios zod chalk
# or scan your own project:
npx proof-of-commitment --file package.json
# PyPI too:
npx proof-of-commitment --pypi litellm langchain requests웹 데모 (설치 불필요): getcommit.dev/audit — 패키지를 붙여넣고 몇 초 만에 위험 점수를 확인하세요.
MCP 서버 (설치 불필요):
{
"mcpServers": {
"proof-of-commitment": {
"type": "streamable-http",
"url": "https://poc-backend.amdal-dev.workers.dev/mcp"
}
}
}Claude Desktop, Cursor, Windsurf 또는 MCP 호환 AI 도구에 추가하세요. 그런 다음 다음과 같이 질문하세요:
"내 package.json의 공급망 위험을 감사해 줘" "axios, zod, chalk, lodash의 점수를 매겨줘 — 가장 위험한 것은 무엇인가?" "vercel/ai는 활발하게 유지보수되고 있는가?"
GitHub Action
모든 CI 파이프라인에 공급망 감사를 추가하세요. package.json 또는 requirements.txt에서 패키지를 자동 감지하고, 결과를 PR 댓글로 게시하며, GitHub Step Summary에 기록하고, 선택적으로 CRITICAL 패키지 발견 시 실패하도록 설정할 수 있습니다.
# .github/workflows/supply-chain-audit.yml
name: Supply Chain Audit
on: [push, pull_request]
jobs:
audit:
runs-on: ubuntu-latest
permissions:
pull-requests: write # needed for PR comments
steps:
- uses: actions/checkout@v4
- uses: piiiico/proof-of-commitment@main
with:
fail-on-critical: false # set true to block merges
comment-on-pr: true # posts audit table directly on the PRcomment-on-pr: true(기본값)로 설정하면, 액션이 자동으로 감사 표를 PR 댓글로 게시합니다. 재실행 시 동일한 댓글을 업데이트하므로 댓글 스팸이 발생하지 않습니다. 검토자는 PR을 떠나지 않고도 위험 표를 확인할 수 있습니다.
입력값:
입력 | 기본값 | 설명 |
| (자동) | 쉼표로 구분된 패키지 이름 (설정되지 않은 경우 |
|
| CRITICAL 패키지 발견 시 워크플로우 실패 처리 |
|
| 자동 감지 시 감사할 최대 패키지 수 |
|
| 감사 결과를 PR 댓글로 게시 ( |
출력값: has-critical, critical-count, audit-summary (마크다운 표, Step Summary에도 기록됨).
PR 댓글 / Step Summary 출력 예시:
| Package | Risk | Score | Maintainers | Downloads/wk | Age |
|---------|-------------|-------|-------------|--------------|-------|
| chalk | 🔴 CRITICAL | 75 | 1 | 380M | 12.7y |
| zod | 🔴 CRITICAL | 83 | 1 | 133M | 6.1y |
| axios | 🔴 CRITICAL | 89 | 1 | 93M | 11.6y |README 배지
유지보수하거나 의존하는 모든 패키지에 헌신 점수 배지를 추가하세요:
예시:
패키지 | 배지 URL |
axios |
|
zod |
|
litellm |
|
색상: 🟢 건강함 (75+) · 🟡 양호 (60–74) · 🟡 보통 (40–59) · 🟠 고위험 (<40) · 🔴 CRITICAL (유지보수자 1명 + 주당 1,000만 다운로드 초과)
배지는 Cloudflare 엣지에서 5분간 캐시됩니다. API 키가 필요하지 않습니다.
REST API
API 키 불필요. 설치 불필요.
curl https://poc-backend.amdal-dev.workers.dev/api/audit \
-X POST \
-H "Content-Type: application/json" \
-d '{"packages": ["axios", "zod", "chalk", "lodash", "express"]}'{
"count": 5,
"results": [
{
"name": "chalk",
"ecosystem": "npm",
"score": 75,
"maintainers": 1,
"weeklyDownloads": 398397580,
"ageYears": 12.7,
"trend": "stable",
"riskFlags": ["CRITICAL"]
},
...
]
}7가지 MCP 도구
도구 | 설명 |
| 최대 20개의 npm/PyPI 패키지에 대한 일괄 위험 감사 |
| 단일 npm 패키지 행동 프로필 |
| 단일 PyPI 패키지 행동 프로필 |
| GitHub 저장소 헌신 점수 (수명, 커밋 빈도, 기여자 깊이) |
| 노르웨이 기업 등록부 — 운영 연수, 직원 수, 재무 정보 |
| 위와 동일, 조직 번호 기준 |
| 브라우저 확장 프로그램 행동 데이터 (고유 검증 방문자, 재방문율) |
점수 측정 기준
각 패키지는 0~100점 사이로 평가됩니다:
수명 — 패키지가 얼마나 오래 존재했는가? 방치된 패키지는 공격을 위해 재활성화됩니다.
유지보수자 깊이 — 단일 유지보수자 + 주당 수백만 다운로드 = LiteLLM이 악용당한 공격 표면.
릴리스 일관성 — 정기적인 릴리스는 활발한 감독을 의미합니다. 긴 공백은 취약점 축적을 의미합니다.
다운로드 추세 — 성장하는 패키지는 더 많은 조사(및 공격)를 유도합니다. 안정적인 패키지는 낮은 프로필을 유지합니다.
위험 플래그:
CRITICAL— 단일 유지보수자 + 주당 1,000만 다운로드 초과 (LiteLLM/axios 공격 프로필과 일치)HIGH— 1년 미만의 패키지 + 빠른 채택WARN— 12개월 이상 릴리스 없음
실제 데이터 포인트
chalk — score 75, 1 maintainer, 399M/week ⚑ CRITICAL
zod — score 83, 1 maintainer, 139M/week ⚑ CRITICAL
axios — score 89, 1 maintainer, 96M/week ⚑ CRITICAL (attacked Apr 1 2026)
lodash — score 88, 3 maintainers, 68M/week
express — score 91, 5 maintainers, 35M/week
litellm — score 74, 1 maintainer ⚑ CRITICAL (supply chain attack Mar 2026)행동 신호가 중요한 이유
LiteLLM 공격(2026년 3월)과 axios 공격(2026년 4월)은 동일한 패턴을 따랐습니다: 자격 증명 탈취 → 악성 패키지 배포 → 9,700만 대 이상의 기기 노출. 두 패키지 모두 공격 이전에 이러한 지표에 의해 CRITICAL 점수를 받았습니다.
선언적 신호(별점, README 품질, CI 배지)는 이러한 위험을 포착하지 못합니다. 행동적 헌신은 포착합니다.
공식 MCP 레지스트리에 등재됨
registry.modelcontextprotocol.io → io.github.piiiico/proof-of-commitment기술 스택
계층 | 기술 |
백엔드 | Cloudflare Workers + D1 |
MCP | Model Context Protocol SDK |
데이터 | npm registry, PyPI, GitHub API, Brønnøysund (NO) |
랜딩 | Astro + Cloudflare Pages |
더 넓은 비전
공급망 감사는 첫 번째 도구일 뿐입니다. 근본적인 원리는 **헌신 그래프(commitment graph)**입니다. 이는 모든 도메인에서 콘텐츠 기반의 신뢰를 대체하는 행동 신호입니다.
콘텐츠(리뷰, 별점, README)를 위조하기 쉬운 세상에서, 헌신은 신뢰의 신호가 됩니다. 12년 동안 847번의 릴리스를 수행한 유지보수자의 헌신은 2023년에 한 번 게시한 사람의 헌신과는 차원이 다릅니다.
동일한 논리가 웹사이트, 기업, AI 에이전트에도 적용됩니다. 두 개의 카드 네트워크가 독립적으로 이 격차를 지적했습니다: Mastercard Verifiable Intent §9.2는 행동적 신뢰를 "다루지 않음"으로 명시합니다. Visa TAP은 에이전트를 식별하지만 신뢰 여부는 답하지 않습니다.
Proof of Commitment는 그들이 지목하는 신뢰 계층입니다.
로컬 실행
bun install
bun run dev:backend # local server with SQLite
bun run test:e2e # E2E test with mock World ID배포:
bun run deploy # deploys to Cloudflare WorkersAvailable Tools
8 toolsaudit_dependenciesAInspect
Batch-score multiple npm or PyPI packages for supply chain risk. Takes a list of package names and returns a risk table sorted by commitment score (lowest = highest risk first).
Risk flags:
CRITICAL: single npm publisher + >10M weekly downloads (publish-access concentration risk)
HIGH: new package (<1yr) + high downloads (unproven, rapid adoption = supply chain risk)
WARN: no release in 12+ months (potential abandonware)
WARN: dormant publishers with current scope access — contributors who stopped publishing but retain npm tokens (the Mastra incident vector, June 2026)
Perfect for auditing a full package.json or requirements.txt — paste your dependency list and get a prioritized risk report.
Examples: score all deps in a project, compare two similar packages, identify abandonware before it becomes a CVE.
Inputs: packages (required), ecosystem.
lookup_businessBInspect
Search for a Norwegian business and get its commitment profile from public data (Brønnøysund Register Centre). Returns real commitment signals that can't be faked:
Temporal commitment: how long the business has operated
Financial commitment: revenue, profitability, equity health
Operational commitment: employee count, active status
Overall commitment score (0-100)
Data source: Norwegian government registers (Brreg). No user-contributed data needed — immediate trust verification for any Norwegian business.
Inputs: query (required), maxResults.
lookup_business_by_orgAInspect
Look up a specific Norwegian business by organization number and get its commitment profile from public data (Brønnøysund Register Centre). Returns real commitment signals: longevity, financial health, operational activity, and overall commitment score.
Inputs: orgNumber (required).
lookup_github_repoAInspect
Get a behavioral commitment profile for any public GitHub repository. Returns real signals: how long the project has existed, recent commit frequency, contributor community size, release cadence, and social proof. These are behavioral commitments — harder to fake than README claims.
Useful for: vetting open-source dependencies, evaluating AI tools/frameworks, assessing vendor reliability. Examples: "vercel/next.js", "facebook/react", "https://github.com/piiiico/proof-of-commitment"
Inputs: repo (required).
lookup_go_moduleAInspect
Get a behavioral commitment profile for any Go module on proxy.golang.org. Takes a full module path (e.g., "github.com/gin-gonic/gin", "golang.org/x/net", "k8s.io/client-go", "gopkg.in/yaml.v3") and returns real signals: module age, version count, publish cadence, GitHub contributors (the closest equivalent to "publishers" since Go has no centralized publisher concept — git push access is the publish equivalent), GitHub stars, OpenSSF Scorecard score.
The Go ecosystem has no centralized download counter, so this profile is GitHub-primary — the linked source repository's activity, contributor count, and Scorecard carry more weight than for npm/PyPI/Cargo. Stars are used as the popularity proxy.
Useful for: vetting Go dependencies before adding to go.mod, identifying abandonware, supply chain risk assessment. Examples: "github.com/gin-gonic/gin", "golang.org/x/crypto", "github.com/spf13/cobra", "k8s.io/api"
Inputs: module (required).
lookup_npm_packageAInspect
Get a behavioral commitment profile for any npm package. Returns real signals: package age, download volume and trend (growing/stable/declining), release consistency, npm publisher count, GitHub contributor count, and linked GitHub activity.
Also returns publisherLifecycle — cross-referencing current maintainers against per-version publish history to flag dormant publishers who still hold npm scope access. The Mastra incident (June 2026) exploited exactly this: a contributor dormant since 2024 with never-revoked scope access.
Supply chain attacks target packages with low publisher depth (few people with npm publish access). Behavioral signals reveal what download counts hide.
Useful for: vetting dependencies, identifying abandonware, due diligence on open-source packages. Examples: "langchain", "@anthropic-ai/sdk", "express", "litellm"
Inputs: package (required).
lookup_pypi_packageAInspect
Get a behavioral commitment profile for any PyPI (Python) package. Returns real signals: package age, download volume and trend, release consistency, publisher/owner count, and linked GitHub activity.
Supply chain attacks target Python packages — LiteLLM (97M downloads/mo) was compromised via stolen PyPI token in March 2026. Behavioral signals reveal what star counts hide.
Useful for: vetting Python dependencies, identifying abandonware, supply chain risk due diligence. Examples: "langchain", "litellm", "openai", "anthropic", "requests", "fastapi", "pydantic"
Inputs: package (required).
query_commitmentAInspect
Query verified behavioral commitment data for a domain. Returns aggregated signals: unique verified visitors, repeat visit rate, and average time spent. These prove real human engagement — harder to fake than reviews or content.
Inputs: domain (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
The package-ecosystem lookups (npm, PyPI, Go, GitHub) are clearly scoped to distinct registries, and audit_dependencies is obviously batch-oriented. The only real overlap is lookup_business vs lookup_business_by_org, which differ mainly by input (name search vs org number), and query_commitment's domain-based scope is somewhat fuzzy against the package lookups since package profiles also aggregate engagement signals.
All eight tools use snake_case verb_noun form, with six sharing a lookup_ prefix and the rest using query_/audit_ verbs appropriately. Minor inconsistency in the noun portion of the lookup family (github_repo vs go_module vs pypi_package vs npm_package vs business), but the pattern remains predictable.
Eight tools is well inside the sweet spot for a registry/commitment-scoring server. Each tool maps to a distinct data source or aggregation mode, and none feels redundant padding.
The surface covers Norwegian business data, four code-ecosystem sources, domain engagement, and batch risk auditing — a coherent lifecycle from single lookup to prioritized audit. Gaps remain: audit_dependencies only handles npm/PyPI (not Go/GitHub), and other major ecosystems (Cargo, RubyGems, Maven) have no lookup at all, but agents can work around these.
Maintenance
Related MCP Connectors
Audit GitHub repos for malicious and supply-chain code before you depend on them.
Package versions, licences and known vulnerabilities for npm, PyPI, crates, Go, Maven, NuGet
Evaluates any GitHub repository for license risk, maintenance velocity, stars/forks, and supply-c.
Safety grade (A to F) for any public GitHub repo, in plain English, before you install it.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceDeterministic supply-chain provenance, SBOM/AI-BOM generation, and dependency risk analysis for npm and PyPI packages, with 14 security rules and verifiable reports.1MIT- AlicenseAqualityBmaintenanceEnables AI coding agents and CI to vet npm dependencies before they reach the lockfile, flagging hallucinated, slopsquatted, or otherwise risky packages with evidence-backed verdicts.352 npm4MIT
- AlicenseNot gradedqualityBmaintenanceEnables safety-ranked discovery of open-source components across npm, PyPI, crates.io, RubyGems, GitHub, and Hugging Face, with license, security, and health checks.1,348 npmMIT
- AlicenseAqualityBmaintenanceScores npm packages, PyPI packages and GitHub repositories 0-100 with an A-F grade and plain-language risks. Scans package.json, requirements.txt and lock files; no API key needed.367 npm1Apache 2.0