secure-api MCP sunucusu
Commit 12 Kas 2026Hassas verilerin AI istemcilerine sızmasını önlemek için çıktıları temizlerken, çalışma zamanında komutlara ve API çağrılarına gizli bilgileri (secrets) enjekte eder.
Ayrıca bilinen adı than/secure-api-mcp
- Yıldızlar
- 5
- Araçlar
- 5
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 12 Kas 2026
- Lisans
- —
secure-api MCP nedir?
secure-api bir MCP sunucusudur. Hassas verilerin AI istemcilerine sızmasını önlemek için çıktıları temizlerken, çalışma zamanında komutlara ve API çağrılarına gizli bilgileri (secrets) enjekte eder. 5 araç sunar; örneğin get_env_keys, run_with_env, api_call.
Özet, projenin README dosyasından oluşturuldu
secure-api MCP sunucusu hakkında
Bu sunucu, hassas kimlik bilgilerinin Claude Code gibi AI istemcileri tarafından önbelleğe alınmasını veya okunmasını engellemenizi sağlar. Geliştiricilerin, gerçek gizli değerleri konuşma bağlamında hiçbir zaman ifşa etmeden, bir AI ajanı için ortam değişkenlerini ve yapılandırma dosyalarını kullanma yeteneği sağlamasına olanak tanır. Gizli bilgileri çalışma zamanında komutlara ve HTTP isteklerine enjekte edip ardından ortaya çıkan çıktıyı maskeleyerek, özel anahtarlarınız ile LLM arasında bir güvenlik katmanı oluşturur.
Kullanıcılar, yapılandırılmış HTTP istekleri için api_call ve kabuk komutlarını çalıştırmak için run_with_env gibi özel araçlar aracılığıyla gizli bilgileri yönetebilirler. Sunucu ayrıca read_mycnf aracılığıyla MySQL kimlik bilgilerini yönetir ve sync_env_example kullanarak dokümantasyonun güncel tutulmasına yardımcı olur. Güvenliği sağlamak için api_call aracı SSRF koruması içerir ve SECURE_API_ALLOWED_HOSTS ortam değişkeni aracılığıyla bir host izin listesini destekler. Bu kurulum, geliştiricilerin dosya geçmişinde düz metin gizli bilgilerin sessizce depolanmasını önlerken Claude Code kullanmak istedikleri yerel geliştirme ortamları için tasarlanmıştır.
Neler yapabilirsiniz
- 1Gizli bilgilerle kabuk komutları çalıştırmaAI'nın çıktıdaki değerleri görmesine izin vermeden, ortam değişkenleri gerektiren bir terminal komutu çalıştırın.
- 2Güvenli API istekleri gerçekleştirmeHedefin yetkilendirildiğinden emin olurken, Bearer token'lar veya özel header'lar içeren HTTP çağrıları yapın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
secure-api MCP araçları 5
README dosyasından algılandıget_env_keysrun_with_envapi_callread_mycnfsync_env_example
| get_env_keys | — | |
| run_with_env | — | |
| api_call | — | |
| read_mycnf | — | |
| sync_env_example | — |
Yapılandırma
SECURE_API_ALLOWED_HOSTS
| Ad | Açıklama | Sunucu |
|---|---|---|
| SECURE_API_ALLOWED_HOSTS | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirthan/secure-api-mcp is public and reachablegithub.com/than/secure-api-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-12github.com/than/secure-api-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
secure-api-mcp
MCP server that lets Claude Code use secrets without seeing them.
Claude Code silently reads .env files and caches them in plaintext in ~/.claude/file-history/. This server injects secrets into commands and API calls at runtime, then sanitizes output to strip secret values before they reach Claude's context.
Threat model — read this. The strength of the guard differs by tool:
api_callhas the smallest attack surface: no shell, structured output, SSRF protection, and an optional destination allowlist (see below). Sanitization reliably covers its responses.run_with_envruns an arbitrary shell command. Output sanitization is best-effort, not a hard boundary — a command can re-encode, reverse, chunk, or otherwise transform a secret into a form the sanitizer won't recognize before printing it. Treat it as defense-in-depth.
A secret can only be protected if you control where it goes. Both tools can send a secret to an external destination by design; restrict that with deny rules, the api_call allowlist, and review of run_with_env commands.
Tools
get_env_keys(project_dir)— Returns key names from.env. No values exposed.run_with_env(project_dir, command, env_keys?, timeout_ms?, include_mycnf?)— Runs a shell command with.envvars injected. Output is sanitized — secret values replaced with[REDACTED:KEY_NAME]. Setinclude_mycnfto also sanitize MySQL credentials from.my.cnfin command output.api_call(project_dir, url, method?, headers?, body?, auth_env_key?, timeout_ms?)— HTTP request with secret injection.auth_env_keyadds a Bearer token. Headers support{{KEY_NAME}}template syntax. When a secret is injected, the destination host is checked againstSECURE_API_ALLOWED_HOSTS(see below). Redirects are followed manually, up to 5 hops, with the SSRF guard and the allowlist re-applied to every hop. Times out aftertimeout_ms(default 30s).read_mycnf(project_dir, section?)— Reads MySQL.my.cnfconfiguration. Returns section names and safe fields (port,database,socket) with credentials (user,password,host) redacted as[REDACTED:section.field]. Checks~/.my.cnfand project-local.my.cnf.sync_env_example(project_dir)— Generates/updates.env.examplefrom.env. Preserves comments and structure, strips values, uses smart placeholders.
Setup
npm install && npm run build
Register in Claude Code:
claude mcp add secure-api -- node /path/to/secure-api-mcp/dist/index.js
Pair with deny rules in ~/.claude/settings.json to block direct .env reads:
"deny": [
"Read(.env)", "Read(**/.env)",
"Read(.env.local)", "Read(**/.env.local)",
"Edit(.env)", "Edit(**/.env)"
]
Keeping .env.example in sync
Run sync_env_example to generate or update .env.example from your .env. It:
- Preserves comments and blank lines from
.env - Strips secret values, replacing them with smart placeholders (URLs stay URL-shaped, booleans stay as-is, numbers stay as-is, everything else blanked)
- Merges with any existing
.env.example— custom placeholders you've added won't be overwritten - Lets Claude read
.env.examplefreely (since deny rules only block.env) so it knows what config exists without seeing values
Pair this with get_env_keys and Claude has full awareness of your project's config without any secret exposure.
Restricting where api_call can send secrets
By default api_call will attach a secret to a request bound for any public host (internal/private IPs are always blocked for SSRF). To restrict this, set SECURE_API_ALLOWED_HOSTS to a comma-separated list of permitted hosts:
export SECURE_API_ALLOWED_HOSTS="api.stripe.com,api.github.com,*.internal.example.com"
- Set — a request that injects a secret is blocked unless its host matches.
*.example.commatches any subdomain and the apexexample.com. Matching is case-insensitive. - Unset — secrets are still sent (so existing setups keep working), but the response includes a
warningsentry naming the destination host.
Requests that inject no secret are never gated.
MySQL .my.cnf support
Claude can work with MySQL configs without seeing your credentials. read_mycnf exposes structural fields (port, database, socket) while redacting user, password, and host. When running MySQL commands via run_with_env, set include_mycnf: true to sanitize any credential values that appear in command output — the mysql CLI reads ~/.my.cnf natively, so no env var injection is needed.
Resolution order matches MySQL's own: ~/.my.cnf (global), then <project_dir>/.my.cnf (project-local overrides global per-field). !include and !includedir directives are followed. Includes in the project-local chain are contained to the project directory (resolved through symlinks) so a crafted project .my.cnf can't disclose files elsewhere on disk; the trusted global ~/.my.cnf chain is unrestricted.
How sanitization works
Secret values of 4 or more characters are replaced in all output, sorted longest-first to prevent partial matches. A value like sk-abc123xyz becomes [REDACTED:API_KEY]. The literal value, its base64 form, and its URL-encoded form are all matched, followed by a pattern pass for common token shapes (AWS, GitHub, Stripe, Slack, JWTs, private keys). Values transformed in other ways (hex, reversed, split across lines) are not caught — this is why run_with_env output is best-effort, not a guarantee.
License
MIT
secure-api MCP soruları
secure-api MCP hangi araçları sunar?
5 araç sunar; bunlar arasında get_env_keys, run_with_env, api_call, read_mycnf, sync_env_example yer alır.
Sunucu, gizli bilgilerimi Claude tarafından görülmekten nasıl korur?
Sunucu, gizli bilgileri çalışma zamanında komutlara ve API çağrılarına enjekte eder ve ardından bu değerlerin AI bağlamına ulaşmadan önce temizlenmesi için çıktıları sanitize eder (temizler).
Kabuk (shell) komutu çıktılarının temizlenmesi garanti midir?
Hayır, kabuk komutları için temizleme işlemi en iyi çaba (best-effort) prensibiyle çalışır. Bir komut, gizli bir bilgiyi yeniden kodlayabilir veya dönüştürebilir, bu durumda temizleyici bunu tanıyamayabilir.
api_call aracının hangi hostlara gizli bilgi gönderebileceğini kısıtlayabilir miyim?
Evet, gizli bilgi enjekte eden istekleri sınırlandırmak için SECURE_API_ALLOWED_HOSTS ortam değişkenini izin verilen hostların virgülle ayrılmış bir listesi olarak ayarlayabilirsiniz.