Melakukan pemindaian keamanan menggunakan bahasa Inggris sederhana pada aplikasi yang dibangun dengan AI dan menghasilkan permintaan perbaikan untuk coding agent.
Juga dikenal sebagai contentasoftware/appledger
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.2.5
- Commit terakhir
- 14 Okt 2026
- Lisensi
- MIT
Apa itu AppLedger MCP?
Melakukan pemindaian keamanan menggunakan bahasa Inggris sederhana pada aplikasi yang dibangun dengan AI dan menghasilkan permintaan perbaikan untuk coding agent.
Ringkasan dibuat dari README proyek
Tentang AppLedger MCP server
AppLedger menyediakan feedback keamanan untuk aplikasi yang dibangun menggunakan tool AI seperti Claude Code, Cursor, dan Lovable. Tool ini memindai folder aplikasi menggunakan tool independen untuk mengidentifikasi kerentanan dan menerjemahkan temuan teknis ke dalam bahasa Inggris yang mudah dipahami. Layanan ini membantu developer memahami apa yang salah, mengapa hal itu penting, dan bagaimana cara memperbaikinya. AppLedger juga menghasilkan file fix-prompt.md khusus yang dapat diberikan langsung kembali ke coding agent untuk menyelesaikan masalah tersebut.
Pengguna dapat memilih antara mode hosted atau mode lokal. Dalam mode hosted, file yang akan di-commit oleh Git akan di-zip dan dikirim via HTTPS ke appledger.net untuk dipindai, sementara file sensitif seperti .env atau SSH keys akan dikecualikan secara ketat. Mode lokal menjaga semua kode tetap berada di mesin Anda dengan menggunakan versi Trivy dan Opengrep yang terinstall. Sistem menggunakan Trivy untuk menemukan kebocoran key dan library yang sudah usang, sementara Opengrep mendeteksi pola berbahaya seperti SQL injection. Bagi Anda yang sudah memiliki server SonarQube, mode lokal secara opsional dapat menyertakan pemindaian tersebut untuk memeriksa kualitas kode dan security hotspots.
Apa yang bisa Anda lakukan dengannya
- 1Generate permintaan perbaikan AIBuat file markdown berisi set instruksi siap pakai yang dapat Anda berikan kepada coding agent untuk memperbaiki celah keamanan.
- 2Audit kode hasil generate AI dari kerentananPindai folder aplikasi Anda untuk menemukan kebocoran password, library yang usang, atau pola berbahaya seperti SQL injection.
- 3Otomatisasi inspeksi keamanan rutinSiapkan pemindaian otomatis harian atau mingguan menggunakan scheduler sistem seperti cron atau Windows Task Scheduler.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal AppLedger MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal AppLedger MCP di Claude Code
$ claude mcp add --env 'APPLEDGER_KEY=<YOUR_APPLEDGER_KEY>' appledger -- uvx appledgerInstal AppLedger MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"appledger": {
"command": "uvx",
"args": [
"appledger"
],
"env": {
"APPLEDGER_KEY": "<YOUR_APPLEDGER_KEY>"
}
}
}
}Instal AppLedger MCP di VS Code
.vscode/mcp.json
{
"servers": {
"appledger": {
"type": "stdio",
"command": "uvx",
"args": [
"appledger"
],
"env": {
"APPLEDGER_KEY": "<YOUR_APPLEDGER_KEY>"
}
}
}
}Instal AppLedger MCP di VS Code CLI
$ code --add-mcp '{"name":"appledger","type":"stdio","command":"uvx","args":["appledger"],"env":{"APPLEDGER_KEY":"<YOUR_APPLEDGER_KEY>"}}'Instal AppLedger MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"appledger": {
"command": "uvx",
"args": [
"appledger"
],
"env": {
"APPLEDGER_KEY": "<YOUR_APPLEDGER_KEY>"
}
}
}
}Instal AppLedger MCP di Codex
$ codex mcp add appledger --env 'APPLEDGER_KEY=<YOUR_APPLEDGER_KEY>' -- uvx appledgerInstal AppLedger MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.appledger] command = "uvx" args = ["appledger"] [mcp_servers.appledger.env] APPLEDGER_KEY = "<YOUR_APPLEDGER_KEY>"
Instal AppLedger MCP di Gemini CLI
$ gemini mcp add -s user -e 'APPLEDGER_KEY=<YOUR_APPLEDGER_KEY>' appledger uvx -- appledgerInstal AppLedger MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"appledger": {
"command": "uvx",
"args": [
"appledger"
],
"env": {
"APPLEDGER_KEY": "<YOUR_APPLEDGER_KEY>"
}
}
}
}Konfigurasi
APPLEDGER_KEYRahasiaOptional dashboard connection key (al_...). Without it, nothing goes to a dashboard; a hosted check returns a link that saves its result to a free account (the summary is kept up to 24 hours).
APPLEDGER_MODEhosted (default): files Git would commit are sent to appledger.net, scanned and deleted. local: Trivy and Opengrep run on this machine.
| Nama | Deskripsi | Tipe |
|---|---|---|
| APPLEDGER_KEY | Optional dashboard connection key (al_...). Without it, nothing goes to a dashboard; a hosted check returns a link that saves its result to a free account (the summary is kept up to 24 hours). | Rahasia |
| APPLEDGER_MODE | hosted (default): files Git would commit are sent to appledger.net, scanned and deleted. local: Trivy and Opengrep run on this machine. |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaucontentasoftware/appledger is public and reachablegithub.com/contentasoftware/appledger ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaappledger names contentasoftware/appledger as sourcepypi.org/project/appledger/ ↗Lolos
- Provenance build (atestasi Sigstore)Sigstore attestation for appledgerpypi.org/project/appledger/ ↗Lolos
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-14github.com/contentasoftware/appledger ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from appledgerLolos
- Tidak ada advisory kritis pada paket atau dependensinya32 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubAppLedger honest check
Honest security feedback, in plain language, for apps people build with AI tools such as Claude Code, Codex, Cursor and Lovable.
AppLedger checks your app folder with independent scanners and explains what they find in everyday words: what is wrong, why it matters, and what to do. It also writes a fix request you can hand straight to the AI tool that built the app, then checks again.
What it checks
| Scanner | Finds |
|---|---|
| Trivy | Leaked passwords and keys, outdated libraries with known security problems, risky container setup |
| Opengrep | Dangerous code patterns: SQL injection, command injection, unsafe data loading, debug mode left on |
| SonarQube (optional, local mode) | Code quality and more security hotspots, if you already run a SonarQube server |
Each run produces, in <your-app>/.appledger/:
report.html: a score, who may use the app right now (only you, your team, the whole company), and every problem in plain wordsfix-prompt.md: a ready-made fix request for your coding agentfindings.json: the same findings for tools and dashboards
Two ways to run
| Mode | What you install | Where your code goes |
|---|---|---|
| Hosted (default) | Only this package | Source files Git would commit are zipped, sent over HTTPS to appledger.net, scanned and deleted right after. Secret files are never sent. You confirm before the first upload of each folder |
Local (--local or APPLEDGER_MODE=local) |
Also Trivy, Opengrep and the Opengrep rules | Stays on your computer. With a connection key, only a summary goes to your dashboard (see below); --no-dashboard skips even that |
What gets uploaded in hosted mode
- Sent: files Git would commit (
git ls-files, including new files that aren't ignored). Outside a Git repository,.gitignoreis still honoured. - Never sent:
.envand.env.*(except.env.example,.env.sample,.env.template),*.pem,*.key,*.p12,*.pfx, SSH keys,.npmrc,.pypirc,.netrc,*credentials*.json,service-account*.json,secrets.*, the folderscert,certs,secrets,.sshand.aws,.claude/settings.local.json, Terraform state, password files, Ansible Vault files, Kubernetes/Helm secret manifests, certificates and similar (full list insrc/appledger/uploadpolicy.py). The server drops such files again as a second safety net. - Skipped: dependencies, build output, media, documents and data files (CSV, spreadsheets, slides, SQL, logs, data dumps) and files over 1 MB.
If a secret file is committed to Git or not ignored, the check reports it as a problem by file name. Its content is never read or sent.
See exactly what would be sent, and what is left out and why, without uploading anything:
python -m appledger path/to/your-app --list-files
The first hosted check of a folder asks you to confirm. In scripts and scheduled runs, pass --yes. If the code belongs to your employer or a client, make sure you're allowed to upload it, or use local mode.
Install
Claude Code plugin (recommended: adds the guided check-my-app skill):
claude plugin marketplace add contentasoftware/appledger
claude plugin install appledger@appledger
In the Claude Code desktop app, add the marketplace contentasoftware/appledger in the plugin settings instead. Start a new session, then ask: "Is my app safe to share?" or "Add this app to AppLedger".
MCP server only (needs uv):
claude mcp add appledger -- uvx --from appledger appledger-mcp
Command line:
pip install appledger
python -m appledger path/to/your-app
Step-by-step guide with troubleshooting: https://appledger.net/docs/
Version 0.2.0 (upload preview, consent, secret-file exclusion, scheduling) is being released to PyPI; until then pip install appledger gets 0.1.x.
Company dashboard
Create a free account at appledger.net to keep every app your people check in one ledger: owner, grade, score trend, who may use it and which AI tool built it. Create a connection key under "Connect a computer", then save it on each computer:
python -m appledger --connect al_your_key
Or tell Claude: "Connect AppLedger with this key: al_…". The key is saved in ~/.appledger/key; APPLEDGER_KEY overrides it and --disconnect removes it.
From then on each check also saves a summary to your dashboard: the app's name, score, grade, problem counts, the list of problems found (level and short title, up to 60; never code or file paths), and the scanners used. Never the code.
Not connected yet? From 0.2.3, a hosted check from a computer without a key ends with a save link, also shown in report.html:
Save this result to a free AppLedger ledger (link works for 24 hours): https://appledger.net/app/claim.php?t=...
Open it, create a free account or log in, and the check is in your ledger; the page then offers a key for that computer. Until the link is used, the service keeps only the check's summary (app name, score, the problems' levels and titles; never code), for up to 24 hours. A link works once; --no-dashboard turns it off.
You can also add an app in the web app with Add app: register it without code, or upload a zip to check it in the browser (the zip is scanned and deleted the same way).
Scheduled checks
python -m appledger path/to/your-app --schedule weekly --yes # or daily
python -m appledger --schedules # list
python -m appledger path/to/your-app --schedule off # stop
Uses Windows Task Scheduler on Windows and cron on macOS and Linux. Hosted scheduled checks need the one-time --yes consent; add --local to schedule local checks instead. --quiet prints one line per check.
Local mode setup
- Trivy:
winget install AquaSecurity.Trivy(Windows) orbrew install trivy(Mac) - Opengrep: download from the releases page and put it on your PATH
- Rules:
git clone --depth 1 https://github.com/opengrep/opengrep-rules.git ~/.appledger/opengrep-rules - Check:
python -m appledger --doctor
Repository layout
| Path | What |
|---|---|
src/appledger/scanner.py |
Scanners, plain-language translation, report and fix request |
src/appledger/client.py |
Picks the files to send (honouring .gitignore) and sends them to the hosted service |
src/appledger/uploadpolicy.py |
The full list of secret files that are never uploaded, used by client and server |
src/appledger/service.py |
Server side: unpacks an upload safely and scans it |
src/appledger/server.py |
Local MCP server used by the plugin |
plugin/ |
Claude Code / Codex plugin with the check-my-app skill |
tests/mcp_smoke.py |
Calls every MCP tool like an agent would |
License
MIT. The Opengrep community rules used by the scanner have their own license (Commons Clause); check it before using them in a paid service.
Pertanyaan tentang AppLedger MCP
Bagaimana cara menambahkan AppLedger MCP ke Claude Code?
Jalankan claude mcp add --env 'APPLEDGER_KEY=<YOUR_APPLEDGER_KEY>' appledger -- uvx appledger di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan AppLedger MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Bagaimana cara saya menggunakan temuan tersebut untuk memperbaiki kode saya?
Tool ini menghasilkan file 'fix-prompt.md' yang merupakan permintaan perbaikan siap pakai yang dapat Anda berikan langsung ke coding agent AI Anda.